List of contracts | Deel

curl -G https://api.letsdeel.com/rest/contracts \
     -H "Authorization: Bearer <token>" \
     -d after_cursor=eyJlZmZlY3RpdmVEYXRlIjoiMjAyMy0wNS0wMyIsImlkIjozOSwibGltaXQiOjMsInJhbmsiOjZ9 \
     -d countries=US \
     -d countries=GB \
     -d currencies=USD \
     -d currencies=GBP \
     -d expand=cost_centers \
     -d expand=custom_fields \
     -d external_id=1234567890 \
     -d external_id_absent=true \
     -d legal_entity_id=123e4567-e89b-12d3-a456-426614174000 \
     -d limit=50 \
     -d order_direction=desc \
     -d search=Test \
     -d sort_by=contract_title \
     -d statuses=waiting_for_client_sign \
     -d statuses=waiting_for_contractor_sign \
     -d team_id=123e4567-e89b-12d3-a456-426614174000 \
     -d types=ongoing_time_based \
     -d types=milestones \
     -d types=pay_as_you_go_time_based

{
  "data": [
    {
      "id": "d0377f58-f152-413a-aa9f-997bdfc61fc2",
      "type": "ongoing_time_based",
      "title": "Ken",
      "client": {
        "team": {
          "id": "d0377f58-f152-413a-aa9f-997bdfc61fc2",
          "name": "Ken"
        }
      },
      "status": "waiting_for_client_sign",
      "created_at": "2019-03-21T13:45:07.515Z",
      "signatures": {
        "client_signed_at": "2019-03-21T13:45:07.515Z",
        "worker_signature": "John Doe",
        "worker_signed_at": "2019-03-21T13:45:07.515Z"
      },
      "invitations": {
        "client_email": "test@example.com",
        "worker_email": "test@example.com"
      },
      "is_archived": false,
      "is_shielded": false,
      "termination_date": "2022-10-21T09:33:12.256Z",
      "fte_percentage": 1
    }
  ],
  "page": {
    "cursor": "eyJ0eXBlIjoiY29udGV4dCIsInN0YXR1cyI6Im5ldyJ9",
    "total_rows": 100
  }
}

Returns a paginated list of contract summaries for the organization, with optional filtering by status, type, team, legal entity, country, currency, external ID, or a name search term. Use GET /contracts/{contract_id} to retrieve full details for a specific contract.

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.letsdeel.com/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/

Query parameters

after_cursorstringOptional

Return next page of results after the given cursor.

limitstringOptionalformat: "^[0-9]+$"Defaults to 50

Return a page of results with the given number of records.

order_directionenumOptional

Order direction of results; ascending or descending.

Allowed values:

typeslist of enumsOptional

Filter contracts by type. A contract is included in the results if its type is in this list.

statuseslist of enumsOptional

Filter contracts by current status. A contract is included in the results if its status is in this list.

team_idstring or list of stringsOptional

Filter contracts for the given team ID(s). A contract is included in the results if its team is in this list.

legal_entity_idstring or list of stringsOptional

Filter contracts for the given legal entity ID(s). A contract is included in the results if its legal entity is in this list.

external_idstringOptional

Filter contracts for the given external ID.

external_id_absentstringOptional

Filter contracts by external ID presence. When true, returns contracts without an external ID. When false, returns contracts with an external ID. Cannot be used with external_id query param when set to true.

countrieslist of stringsOptional

Filter contracts by country codes.

currencieslist of stringsOptional

Filter contracts by currency codes.

searchstringOptional

Include a contract if its name or the contractor's name contains the given search term.

sort_byenumOptional

Sort contracts by the given field name.

Allowed values:

expandlist of enumsOptional

Include additional fields in the response. Multiple values can be passed as comma-separated list.

Allowed values:

Response

Successful operation.

datalist of objects

Array of contract objects.

pageobject

Pagination information for the response.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error