List of contracts | Deel

import requests
url = "https://api.letsdeel.com/rest/v2/contracts"
querystring = {"after_cursor":"eyJlZmZlY3RpdmVEYXRlIjoiMjAyMy0wNS0wMyIsImlkIjozOSwibGltaXQiOjMsInJhbmsiOjZ9","limit":"50","order_direction":"desc","types":"[\"ongoing_time_based\",\"milestones\",\"pay_as_you_go_time_based\"]","statuses":"[\"waiting_for_client_sign\",\"waiting_for_contractor_sign\"]","team_id":"123e4567-e89b-12d3-a456-426614174000","external_id":"1234567890","external_id_absent":"true","countries":"[\"US\",\"GB\"]","currencies":"[\"USD\",\"GBP\"]","search":"Test","sort_by":"contract_title","expand":"cost_centers"}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "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"
    }
  ],
  "page": {
    "cursor": "eyJ0eXBlIjoiY29udGV4dCIsInN0YXR1cyI6Im5ldyJ9",
    "total_rows": 100
  }
}

Retrieve a list of contracts. 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.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## 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 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/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]+$"

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_idstringOptional

Filter contracts for the given team ID. NOTE: All query parameters are technically strings or arrays of strings.

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 strings or stringOptional

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:

expandenumOptional

Include cost centers in the response.

Allowed values:

Response

Successful operation.

datalist of objects

Array of contract objects.

pageobject

Pagination information for the response.

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'

Authentication

Authentication

Query parameters

Response

Errors

Authentication