Retrieve a single person

Deprecated

GET

/people/:hris_profile_id

GET

/rest/people/:hris_profile_id

curl -G https://api.letsdeel.com/rest/people/9b9fc43a-a90c-4615-ac50-baf1e314b53e \
     -H "Authorization: Bearer <token>" \
     -d include_custom_fields=true \
     -d include_worker_relations=true

{
  "data": {
    "id": "9b9fc43a-a90c-4615-ac50-baf1e314b53e",
    "state": "Active",
    "emails": [
      {
        "type": "work",
        "value": "work.email@example.com"
      }
    ],
    "country": "USA",
    "timezone": "EST",
    "addresses": [
      {
        "region": "CO",
        "country": "US",
        "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": "Delivery team"
        },
        "email": "some@example.com",
        "state": "Active",
        "country": "USA",
        "payment": {
          "rate": 100,
          "scale": "hourly",
          "currency": "USD",
          "contract_name": "Contract 1"
        },
        "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",
        "completion_date": "2023-06-20T00:00:00.000Z",
        "contract_status": "waiting_for_client_sign",
        "voluntarily_left": true,
        "contract_coverage": "is_shielded",
        "new_hiring_status": "onboarding_overdue",
        "client_legal_entity": {
          "id": "00000000-0000-0000-0000-000000000000",
          "name": "Acme Corporation"
        },
        "has_eor_termination": true,
        "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",
    "hiring_status": "onboarding",
    "nationalities": [
      "American"
    ],
    "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",
    "active_worker_termination_status": "IN_PROGRESS",
    "profile_organizational_structures": [
      {
        "id": "642b0547-9d80-4d35-a085-dg377ef209d3",
        "name": "Department",
        "teams": [
          {
            "id": "642b0547-9d80-4d35-a085-dg377ef209d3",
            "name": "Team A",
            "positions": [
              {
                "id": "642b0547-9d80-4d35-a085-dg377ef209d3",
                "role": {
                  "id": "642b0547-9d80-4d35-a085-dg377ef209d3",
                  "name": "Role A"
                },
                "is_supportive": true
              }
            ],
            "name_hierarchy": "Team A / Team B"
          }
        ]
      }
    ],
    "direct_employee_termination_last_day": "2023-03-21",
    "custom_fields": [
      {
        "name": "Job title",
        "value": "Software Engineer II"
      }
    ]
  }
}

Returns detailed information about a single person in the organization by their public ID. Returns personal details, employment information, organizational structure, person status, direct manager, custom fields, and related data.

Token scopes: people:read

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

Beta version available: version 2026-10-12 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/

Path parameters

hris_profile_idstringRequiredformat: "uuid"

Unique identifier for the person.

Query parameters

include_custom_fieldsbooleanOptional

Include custom fields in the response.

include_worker_relationsbooleanOptional

Include worker relations in the response.

Response

Successful response

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error