List onboarding employees | Deel

import requests
url = "https://api.letsdeel.com/rest/v2/onboarding/tracker"
querystring = {"search":"John Doe","contractOid":"[\"OMD123\",\"67E890\"]","hiringTypes":"[\"contractor\"]","progressStatuses":"[\"ACTIVE\"]","countries":"[\"USA\",\"Canada\"]","teams":"[\"c64c6715-e0ca-4ff0-aa53-d4c0db499360\"]","legalEntities":"[\"c64c6715-e0ca-4ff0-aa53-d4c0db499360\"]","hrisDirectManagers":"[\"c64c6715-e0ca-4ff0-aa53-d4c0db499360\"]","fromDate":"2024-01-01T00:00:00Z","toDate":"2024-12-31T23:59:59Z","actions":"[\"ONBOARD\",\"COMPLETE\"]","limit":"50","sort_by":"progressStatusWeight","sort_order":"DESC","include_overview":"false"}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "data": [
    {
      "name": "John Doo",
      "contract": {
        "id": "PzpYaren",
        "effective_date": "2021-07-14"
      },
      "progress": {
        "status": "ONBOARDING_OVERDUE",
        "reference_date": "2021-07-14",
        "people_list_status": "onboarding_overdue",
        "subject_to_overdue": true,
        "onboarding_due_date": "2021-07-14T22:00:00+00:00",
        "reference_date_type": "EFFECTIVE_DATE",
        "reference_date_timezone": "Europe/Brussels",
        "is_action_required_from_client": false
      },
      "unique_id": "eyJjb250cmFjdE9pZCI6IlB6cFlhcmVuIiwiaGlyaW5nVHlwZSI6ImNvbnRyYWN0b3IiLCJwcm9maWxlSWQiOjE2NzgyMCwidXNlcklkIjoxNDM3ODl9",
      "hiring_type": "contractor",
      "hris_profile": {
        "oid": "150f635e-fae1-4b9d-9f86-768bbbac3698",
        "work_email": "2635e57fe2a571c1aadba2a77f178e2b@test.com"
      },
      "app_experience": {
        "is_minimal_requirements": false
      }
    }
  ],
  "page": {
    "cursor": "eyJsaW1pdCI6MiwicGFnaW5hdGlvbiI6eyJwcm9ncmVzc1N0YXR1c1dlaWdodCI6MSwicmVmZXJlbmNlRGF0ZSI6IjIwMjEtMDctMThUMjI6MDA6MDArMDA6MDAiLCJlZmZlY3RpdmVEYXRlIjoiMjAyMS0wNy0xOFQyMjowMDowMCswMDowMCIsImNvbnRyYWN0SWQiOiJONzZsWHdreiJ9LCJzb3J0T3JkZXIiOiJBU0MifQ",
    "total_rows": 86
  }
}

List all onboarding Token scopes: contracts:read, people:read

Authentication

AuthorizationBearer

Authentication

Deel API uses API tokens to authenticate requests. A bearer token is required to authenticate all API requests. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. curl -X GET 'api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE'

## Authentication Deel API uses API tokens to authenticate requests. A bearer token is required to authenticate all API requests. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. ``` curl -X GET 'api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` ### Generating Access Tokens 1. Navigate to **Apps & Perks > Developer Center**. 2. Click on the “Generate New Token” button. 3. In the popup, click “Generate Token” button to generate a new token. Your newly generated token is visible on the screen. 4. Make sure to copy and save your token once is generated. You won't be able to see it again!

AuthorizationBearer

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

Query parameters

searchstringOptional

Search term to filter contracts by name or other attributes

contractOidlist of stringsOptional

hiringTypeslist of enumsOptional

Allowed values:

progressStatuseslist of enumsOptional

Allowed values:

countrieslist of stringsOptional

teamslist of stringsOptional

legalEntitieslist of stringsOptional

hrisDirectManagerslist of stringsOptional

fromDatestringOptionalformat: "date-time"

Start date for filtering contracts

toDatestringOptionalformat: "date-time"

End date for filtering contracts

actionslist of enumsOptional

Onboarding actions

Allowed values:

limitintegerOptional>=1Defaults to 20

Number of results to return per page

sort_byenumOptionalDefaults to progressStatusWeight

Field to sort by

Allowed values:

sort_orderenumOptionalDefaults to ASC

Sorting order

Allowed values:

paginationobjectOptional

include_overviewbooleanOptionalDefaults to false

Include an overview of the contract

Response

A list of onboarding and their details

datalist of objects or null

pageobject or null

Authentication

Authentication

Query parameters

Response

Errors

Authentication