List of People

Deprecated

GET

/people

GET

/rest/people

curl -G https://api.letsdeel.com/rest/people \
     -H "Authorization: Bearer <token>" \
     -d band_placements=ABOVE \
     -d band_placements=WITHIN \
     -d comparative_ratios_from=1.1 \
     -d comparative_ratios_to=1.1 \
     -d fields=first_name \
     -d fields=last_name \
     -d fields=emails \
     -d hiring_statuses=active \
     -d hiring_statuses=onboarded \
     -d hiring_types=eor \
     -d hiring_types=contractor \
     -d limit=50 \
     -d offset=150 \
     -d person_statuses=ACTIVE \
     -d person_statuses=INACTIVE \
     --data-urlencode "search=John Doe" \
     -d sort_by=hiring_status \
     -d sort_order=asc \
     -d teams=00000000-0000-0000-0000-000000000000 \
     -d teams=642b0547-9d80-4d35-a085-fd977ef209ef

{
  "data": [
    {
      "id": "9b9fc43a-a90c-4615-ac50-baf1e314b53e",
      "state": "Active",
      "emails": [
        {
          "type": "work",
          "value": "work.email@example.com"
        }
      ],
      "country": "USA",
      "is_pwac": false,
      "timezone": "EST",
      "addresses": [
        {
          "region": "CO",
          "country": "US",
          "lineTwo": "Apt 4B",
          "locality": "Denver",
          "postalCode": "44000",
          "streetAddress": "Deel Street 500"
        }
      ],
      "full_name": "John Doe",
      "job_title": "Access Field Technician",
      "last_name": "Doe",
      "seniority": "Junior (Individual Contributor Level 1)",
      "worker_id": "123",
      "birth_date": "1990-01-01T00:00:00.000Z",
      "created_at": "2023-03-21T10:27:25.950Z",
      "department": {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "Delivery team",
        "parent": "Research and Development"
      },
      "first_name": "John",
      "start_date": "2023-03-20",
      "updated_at": "2022-05-24T09:38:46.235Z",
      "employments": [
        {
          "id": "mzj524j",
          "name": "Khizar Naeem",
          "team": {
            "id": "00000000-0000-0000-0000-000000000000",
            "name": "Engineering Team"
          },
          "email": "some@example.com",
          "state": "Active",
          "country": "USA",
          "payment": {
            "rate": 100.5,
            "scale": "hourly",
            "currency": "USD",
            "contract_name": "Full-time Employment Contract"
          },
          "is_ended": false,
          "timezone": "EST",
          "job_title": "Access Field Technician",
          "seniority": "Junior (Individual Contributor Level 1)",
          "start_date": "2023-03-20",
          "work_email": "work.email@example.com",
          "hiring_type": "contractor",
          "hiring_status": "onboarding",
          "band_placement": "ABOVE",
          "completion_date": "2023-06-20T00:00:00.000Z",
          "contract_status": "waiting_for_client_sign",
          "voluntarily_left": true,
          "comparative_ratio": 1.1,
          "contract_coverage": "is_premium",
          "new_hiring_status": "onboarding_overdue",
          "client_legal_entity": {
            "id": "00000000-0000-0000-0000-000000000000",
            "name": "Acme Corporation"
          },
          "has_eor_termination": true,
          "compensation_band_id": "9b9fc43a-a90c-4615-ac50-baf1e314b53e",
          "contract_is_archived": false,
          "termination_last_day": "2023-03-21T10:27:25.950Z",
          "contract_has_contractor": true,
          "is_user_contract_deleted": false,
          "hris_direct_employee_invitation": {
            "oid": "rJ7PUDgbp9L6",
            "status": "DISABLED",
            "send_at": "2023-03-21T10:27:25.950Z",
            "timezone": "EST"
          }
        }
      ],
      "external_id": "9b9fc43a-a90c-4615-ac50-baf1e314b53e",
      "hiring_type": "contractor",
      "middle_name": "Ann",
      "hiring_status": "onboarding",
      "nationalities": [
        "American"
      ],
      "person_status": "ACTIVE",
      "work_location": "Remote",
      "direct_manager": {
        "id": "642b0547-9d80-4d35-a085-fd977ef209ef",
        "last_name": "John",
        "worker_id": 30,
        "first_name": "Doe",
        "work_email": "john.doe@example.com"
      },
      "direct_reports": [
        {
          "id": "642b0547-9d80-4d35-a085-fd977ef209ef",
          "last_name": "John",
          "first_name": "Doe",
          "work_email": "john.doe@example.com"
        }
      ],
      "completion_date": "2023-06-20T00:00:00.000Z",
      "new_hiring_status": "onboarding_overdue",
      "additional_details": [
        {
          "type": "socialSecurity",
          "value": "123-12-1234",
          "country": "US"
        }
      ],
      "client_legal_entity": {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "Acme Corporation"
      },
      "preferred_last_name": "Doe",
      "direct_reports_count": 0,
      "preferred_first_name": "John",
      "hris_organization_user_id": "9b9fc43a-a90c-4615-ac50-baf1e314b53e",
      "active_worker_termination_status": "IN_PROGRESS",
      "direct_employee_termination_last_day": "2023-03-21T10:27:25.950Z"
    }
  ],
  "page": {
    "offset": 1,
    "total_rows": 1.1,
    "items_per_page": 1.1
  }
}

Returns a paginated list of people records in the organization. Supports filtering by search term, teams, custom fields, and other query parameters. Build people directories, sync HR data, or power search interfaces across your workforce records.

Token scopes: people:read

Deprecated: a newer version of this endpoint is available. This version is scheduled for removal on 2027-09-30.

Beta version available: version 2026-09-30 of this endpoint is in beta. Send X-Beta: true to call it.

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

offsetintegerOptional0-999999999Defaults to 0

Return a page of results with given number of records.

limitintegerOptional1-200

Return a page of results with given number of records.

searchstringOptional

Include a contract if by name or contractor name contains given search term.

teamslist of stringsOptional

Filter the results based on the team(group) the users contract is associated with

fieldslist of enumsOptional

Pick the fields you want to see in the response in order to avoid a bloated people list output. Supports dot notation (e.g., ‘employments[0].contract_status’) to access nested fields.

sort_byenumOptional

Sort people by given field name.

sort_orderenumOptional

Order direction of results; ascending or descending.

Allowed values:

hiring_statuseslist of enumsOptional

Employee's current hiring status.

band_placementslist of enumsOptional

Employee's current band placement.

Allowed values:

comparative_ratios_fromfloatOptional

Employee's minimum band placement

comparative_ratios_tofloatOptional

Employee's maximum band placement

hiring_typeslist of enumsOptional

Filter people by hiring types

person_statuseslist of enumsOptional

Filter people by person (worker profile) lifecycle status.

Allowed values:

Response

Successful response

datalist of objects

pageobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error