List contract amendments | Deel

curl -G https://api.letsdeel.com/rest/contracts/37nex2x/amendments \
     -H "Authorization: Bearer <token>" \
     -d cursor=eyJjcmVhdGVkX2F0IjoiMjAyNC0wMS0xNVQxMDowMDowMC4wMDBaIiwicHVibGljX2lkIjoiYWJjMTIzIn0 \
     -d limit=10 \
     -d sign_statuses=PENDING \
     -d sign_statuses=APPROVED \
     -d statuses=PENDING \
     -d statuses=ACTIVE

{
  "data": [
    {
      "contract_name": "Software Development Contract",
      "contract_type": "ongoing_time_based",
      "created_at": "2024-01-15T10:00:00.000Z",
      "currency_code": "USD",
      "effective_date": "2024-02-01",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "rate": 5000,
      "scale": "monthly",
      "sign_status": "APPROVED",
      "status": "ACTIVE",
      "updated_at": "2024-01-20T14:30:00.000Z"
    }
  ],
  "cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0wMS0xNVQxMDowMDowMC4wMDBaIiwicHVibGljX2lkIjoiZGVmNDU2In0",
  "has_more": true,
  "total_count": 150
}

Returns the amendments of a contract. For Individual Contractor contracts this may include several amendments; for Global Payroll contracts it returns only the current pending amendment, if any.

Token scopes: contracts:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.deel.training/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

contract_idstringRequired

Unique identifier of the contract

Query parameters

statuseslist of enumsOptional

Filter by work statement status.

sign_statuseslist of enumsOptional

Filter by work statement sign status.

Allowed values:

limitintegerOptional1-100Defaults to 20

Maximum number of work statements to return.

cursorstringOptional

Cursor for pagination.

Response

Successful operation.

datalist of objects

List of amendments. IC contracts may return multiple; Global Payroll contracts return at most one (the current pending amendment).

cursorstring or null

Cursor for the next page of results.

has_moreboolean

Indicates if there are more work statements available.

total_countinteger

Total number of work statements matching the filters.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error