Deel subpackage_people API

The subpackage_people API from Deel — 5 operation(s) for subpackage_people.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/deel-subpackage-people-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

deel-subpackage-people-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Endpoints subpackage_people API
  version: 1.0.0
servers:
- url: https://api.letsdeel.com/rest/v2
- url: https://api-staging.letsdeel.com/rest/v2
tags:
- name: subpackage_people
paths:
  /pwac:
    post:
      operationId: create-person-without-contract
      summary: Create a person without a contract
      description: "Create a person without a contract hired under your own entity to Deel's HRIS.\n **Token scopes**: `people:write`"
      tags:
      - subpackage_people
      parameters:
      - name: Authorization
        in: header
        description: "## Authentication\nThe 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.\n\n```curl\ncurl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \\\n  -H 'Authorization: Bearer YOUR-TOKEN-HERE'\n```\n\n[Learn more about authentication](/api/authentication)\n"
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/people_createPersonWithoutContract_Response_201'
        '400':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateAPersonWithoutAContract-v2026-01-01RequestBadRequestError'
        '401':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '403':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '404':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '500':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateAPersonWithoutAContract-v2026-01-01RequestInternalServerError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  $ref: '#/components/schemas/PwacPostRequestBodyContentApplicationJsonSchemaData'
              required:
              - data
  /people:
    get:
      operationId: get-people
      summary: List of People
      description: "Use this endpoint to retrieve people in your organization for building directories or syncing HR data. Paginate with offset/limit and filter with search, teams, and other query parameters. This operation is non-destructive.\n **Token scopes**: `people:read`"
      tags:
      - subpackage_people
      parameters:
      - name: offset
        in: query
        description: Return a page of results with given number of records.
        required: false
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: Return a page of results with given number of records.
        required: false
        schema:
          type: integer
      - name: search
        in: query
        description: Include a contract if by name or contractor name contains given search term.
        required: false
        schema:
          type: string
      - name: teams
        in: query
        description: Filter the results based on the team(group) the users contract is associated with
        required: false
        schema:
          type: array
          items:
            type: string
            format: uuid
      - name: fields
        in: query
        description: 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.
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/PeopleGetParametersFieldsSchemaItems'
      - name: sort_by
        in: query
        description: Sort people by given field name.
        required: false
        schema:
          $ref: '#/components/schemas/PeopleGetParametersSortBy'
      - name: sort_order
        in: query
        description: Order direction of results; ascending or descending.
        required: false
        schema:
          $ref: '#/components/schemas/PeopleGetParametersSortOrder'
      - name: hiring_statuses
        in: query
        description: Employee's current hiring status.
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/PeopleGetParametersHiringStatusesSchemaItems'
      - name: band_placements
        in: query
        description: Employee's current band placement.
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/PeopleGetParametersBandPlacementsSchemaItems'
      - name: comparative_ratios_from
        in: query
        description: Employee's minimum band placement
        required: false
        schema:
          type: number
          format: double
      - name: comparative_ratios_to
        in: query
        description: Employee's maximum band placement
        required: false
        schema:
          type: number
          format: double
      - name: hiring_types
        in: query
        description: Filter people by hiring types
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/PeopleGetParametersHiringTypesSchemaItems'
      - name: person_statuses
        in: query
        description: Filter people by person (worker profile) lifecycle status.
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/PeopleGetParametersPersonStatusesSchemaItems'
      - name: Authorization
        in: header
        description: "## Authentication\nThe 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.\n\n```curl\ncurl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \\\n  -H 'Authorization: Bearer YOUR-TOKEN-HERE'\n```\n\n[Learn more about authentication](/api/authentication)\n"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/people_getPeople_Response_200'
        '400':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '401':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '403':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '404':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOfPeople-v2026-01-01RequestInternalServerError'
    post:
      operationId: create-a-direct-employee
      summary: Create a direct employee
      description: "Create employee hired under your own entity to Deel's HRIS. Manage your employee through Deel and export a payroll report to your own providers.\n **Token scopes**: `people:write`"
      tags:
      - subpackage_people
      parameters:
      - name: Authorization
        in: header
        description: "## Authentication\nThe 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.\n\n```curl\ncurl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \\\n  -H 'Authorization: Bearer YOUR-TOKEN-HERE'\n```\n\n[Learn more about authentication](/api/authentication)\n"
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/People_createADirectEmployee_Response_201'
        '400':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateADirectEmployeeRequestBadRequestError'
        '401':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '403':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '404':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '500':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateADirectEmployeeRequestInternalServerError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  $ref: '#/components/schemas/PeoplePostRequestBodyContentApplicationJsonSchemaData'
              required:
              - data
  /people/{hris_profile_id}:
    get:
      operationId: get-person-by-id
      summary: Retrieve a single person
      description: "Retrieves detailed information about a single person (employee, contractor, or worker) in the organization by their HRIS profile OID, including personal details, employment information, organizational structure, direct manager and reports, custom fields, and related metadata.\n **Token scopes**: `people:read`"
      tags:
      - subpackage_people
      parameters:
      - name: hris_profile_id
        in: path
        description: Unique identifier for the person.
        required: true
        schema:
          type: string
          format: uuid
      - name: include_custom_fields
        in: query
        description: Include custom fields in the response.
        required: false
        schema:
          type: boolean
      - name: include_worker_relations
        in: query
        description: Include worker relations in the response.
        required: false
        schema:
          type: boolean
      - name: Authorization
        in: header
        description: "## Authentication\nThe 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.\n\n```curl\ncurl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \\\n  -H 'Authorization: Bearer YOUR-TOKEN-HERE'\n```\n\n[Learn more about authentication](/api/authentication)\n"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/people_getPersonById_Response_200'
        '400':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '401':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '403':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '404':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RetrieveASinglePersonRequestInternalServerError'
  /people/{id}/working-location:
    put:
      operationId: update-person-working-location
      summary: Update working location
      description: "undefined\n **Token scopes**: `people:write`"
      tags:
      - subpackage_people
      parameters:
      - name: id
        in: path
        description: Hris profile ID
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        description: "## Authentication\nThe 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.\n\n```curl\ncurl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \\\n  -H 'Authorization: Bearer YOUR-TOKEN-HERE'\n```\n\n[Learn more about authentication](/api/authentication)\n"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/people_updatePersonWorkingLocation_Response_200'
        '400':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '401':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '403':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '404':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '500':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  $ref: '#/components/schemas/PeopleIdWorkingLocationPutRequestBodyContentApplicationJsonSchemaData'
              required:
              - data
  /people/me:
    get:
      operationId: get-my-current-personal-profile
      summary: Get my current personal profile
      description: "Retrieve the current user's profile.\n **Token scopes**: `worker:read`, `people:read`"
      tags:
      - subpackage_people
      parameters:
      - name: Authorization
        in: header
        description: "## Authentication\nThe 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.\n\n```curl\ncurl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \\\n  -H 'Authorization: Bearer YOUR-TOKEN-HERE'\n```\n\n[Learn more about authentication](/api/authentication)\n"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/People_getMyCurrentPersonalProfile_Response_200'
        '400':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '401':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '403':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '404':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
        '500':
          description: Operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorContainer'
components:
  schemas:
    people_updatePersonWorkingLocation_Response_200:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/PeopleIdWorkingLocationPutResponsesContentApplicationJsonSchemaData'
      required:
      - data
      title: people_updatePersonWorkingLocation_Response_200
    PwacPostRequestBodyContentApplicationJsonSchemaDataClientLegalEntity:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The legal entity that the person is part of
      required:
      - id
      title: PwacPostRequestBodyContentApplicationJsonSchemaDataClientLegalEntity
    PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataDepartment:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier of this resource.
        name:
          type: string
          description: The name of the department.
        parent:
          type: string
          description: The parent department.
      description: The department of the employee.
      title: PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataDepartment
    PeoplePostResponsesContentApplicationJsonSchemaDataEmployee:
      type: object
      properties:
        email:
          type: string
          format: email
          description: The personal email of the person being hired
        last_name:
          type: string
          description: The last name of the person being hired
        first_name:
          type: string
          description: The first name of the person being hired
        work_email:
          type: string
          format: email
          description: The work email of the person being hired
        external_id:
          type: string
          description: An external identifier for the person being hired
        nationality:
          type: string
          description: The nationality of the person being hired
      required:
      - email
      - last_name
      - first_name
      - nationality
      description: The person that is being hired
      title: PeoplePostResponsesContentApplicationJsonSchemaDataEmployee
    PwacPostRequestBodyContentApplicationJsonSchemaDataInvitation:
      type: object
      properties:
        action:
          $ref: '#/components/schemas/PwacPostRequestBodyContentApplicationJsonSchemaDataInvitationAction'
          description: Controls whether to send an invitation email.
      description: Optional invitation configuration for the new hire. Defaults to 'disable' if not provided.
      title: PwacPostRequestBodyContentApplicationJsonSchemaDataInvitation
    PeopleGetResponsesContentApplicationJsonSchemaDataItemsDirectReportsItems:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the direct report.
        last_name:
          type: string
          description: The last name of the direct report.
        first_name:
          type: string
          description: The first name of the direct report.
        work_email:
          type:
          - string
          - 'null'
          description: The work email of the direct report.
      title: PeopleGetResponsesContentApplicationJsonSchemaDataItemsDirectReportsItems
    PeoplePostResponsesContentApplicationJsonSchemaDataEmployment:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/PeoplePostResponsesContentApplicationJsonSchemaDataEmploymentType'
          description: The type of employment
        country:
          type: string
          description: The country of the employment
        end_date:
          type: string
          format: date
          description: The end date of the employment
        job_title:
          type: string
          description: The job title of the employment
        seniority:
          type: string
          description: The seniority of the employment
        start_date:
          type: string
          format: date
          description: The start date of the employment
        contract_id:
          type: string
          description: The unique identifier of the worker contract
        part_time_percentage:
          type: number
          format: double
          description: The percentage of PART_TIME employment
      required:
      - type
      - country
      - end_date
      - job_title
      - seniority
      - start_date
      - contract_id
      description: The employment details of the employee
      title: PeoplePostResponsesContentApplicationJsonSchemaDataEmployment
    RetrieveASinglePersonRequestInternalServerError:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaError'
      required:
      - error
      title: RetrieveASinglePersonRequestInternalServerError
    PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaData:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the employee.
        state:
          type:
          - string
          - 'null'
          description: The state of the employee.
        emails:
          type: array
          items:
            $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmailsItems'
          description: An array of the employee's email addresses.
        country:
          type:
          - string
          - 'null'
          description: The country of the employee.
        timezone:
          type:
          - string
          - 'null'
          description: The timezone of the employee.
        addresses:
          type: array
          items:
            $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataAddressesItems'
          description: An array of address objects containing the employee's physical addresses.
        full_name:
          type: string
          description: The full name of the employee.
        job_title:
          type:
          - string
          - 'null'
          description: The job title of the employee.
        last_name:
          type: string
          description: The last name of the employee.
        seniority:
          type:
          - string
          - 'null'
          description: The seniority level of the employee.
        worker_id:
          type: string
          description: The worker ID of the employee.
        birth_date:
          type:
          - string
          - 'null'
          description: The birth date of the employee.
        created_at:
          type: string
          format: date-time
          description: The creation timestamp of the employee record.
        department:
          $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataDepartment'
          description: The department of the employee.
        first_name:
          type: string
          description: The first name of the employee.
        start_date:
          type:
          - string
          - 'null'
          format: date
          description: The date the employee started working.
        updated_at:
          type:
          - string
          - 'null'
          format: date-time
          description: Long date-time format following ISO-8601
        employments:
          type: array
          items:
            $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmploymentsItems'
          description: An array of employment records associated with the employee, including contract details, team information, payment details, and employment status.
        external_id:
          type:
          - string
          - 'null'
          description: The external ID of the employee.
        hiring_type:
          type: string
          description: The type of hiring of the employee.
        hiring_status:
          type: string
          description: The current hiring status of the employee.
        nationalities:
          type: array
          items:
            type: string
          description: The nationality of the employee.
        work_location:
          type:
          - string
          - 'null'
          description: The work location of the employee.
        direct_manager:
          oneOf:
          - $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataDirectManager'
          - type: 'null'
          description: The direct manager of the employee.
        direct_reports:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataDirectReportsItems'
          description: The direct reports to the employee.
        completion_date:
          type:
          - string
          - 'null'
          description: The completion date of the task or project.
        new_hiring_status:
          type: string
          description: The new hiring status of the employee.
        client_legal_entity:
          $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataClientLegalEntity'
          description: The primary client legal entity associated with the employee.
        preferred_last_name:
          type:
          - string
          - 'null'
          description: The preferred last name of the employee.
        direct_reports_count:
          type: integer
          description: The count of direct reports to the employee.
        preferred_first_name:
          type:
          - string
          - 'null'
          description: The preferred first name of the employee.
        active_worker_termination_status:
          oneOf:
          - $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataActiveWorkerTerminationStatus'
          - type: 'null'
          description: The status of the active worker termination.
        profile_organizational_structures:
          type: array
          items:
            $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataProfileOrganizationalStructuresItems'
          description: An array of organizational structures associated with the employee profile.
        direct_employee_termination_last_day:
          type: string
          format: date
          description: The last day of work mentioned on the primary contract termination.
        custom_fields:
          type: array
          items:
            $ref: '#/components/schemas/PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataCustomFieldsItems'
          description: An array of custom field objects containing additional attributes associated with the employee (e.g., Job title, Project code, etc.).
      title: PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaData
    PeopleGetResponsesContentApplicationJsonSchemaDataItems:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the employee.
        state:
          type:
          - string
          - 'null'
          description: The state of the employee.
        emails:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmailsItems'
          description: An array of the employee's email addresses.
        country:
          type:
          - string
          - 'null'
          description: The country of the employee.
        is_pwac:
          type: boolean
          description: Whether the worker is a Person Without a Contract (PWAC)
        timezone:
          type:
          - string
          - 'null'
          description: The timezone of the employee.
        addresses:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/PeopleGetResponsesContentApplicationJsonSchemaDataItemsAddressesItems'
          description: An array of address objects containing the employee's physical addresses.
        full_name:
          type: string
          description: The full name of the employee.
        job_title:
          type:
          - string
          - 'null'
          description: The job title of the employee.
        last_name:
          type:
          - string
          - 'null'
          description: The last name of the employee.
        seniority:
          type:
          - string
          - 'null'
          description: The seniority level of the employee.
        worker_id:
          type: string
          description: The worker ID of the employee.
        birth_date:
          type:
          - string
          - 'null'
          description: The birth date of the employee.
        created_at:
          type: string
          format: date-time
          description: The creation timestamp of the employee record.
        department:
          $ref: '#/components/schemas/PeopleGetResponsesContentApplicationJsonSchemaDataItemsDepartment'
          description: The department of the employee.
        first_name:
          type: string
          description: The first name of the employee.
        start_date:
          type:
          - string
          - 'null'
          format: date
          description: The date the employee started working.
        updated_at:
          type:
          - string
          - 'null'
          format: date-time
          description: Long date-time format following ISO-8601
        employments:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmploymentsItems'
          description: An array of employment records associated with the employee, including contract details, team information, payment details, and employment status.
        external_id:
          type:
          - string
          - 'null'
          description: The external ID of the employee.
        hiring_type:
          type:
          - string
          - 'null'
          description: The type of hiring of the employee.
        hiring_status:
          type: string
          description: The current hiring status of the employee.
        nationalities:
          type: array
          items:
            type: string
          description: The nationality of the employee.
        person_status:
          oneOf:
          - $ref: '#/components/schemas/PeopleGetResponsesContentApplicationJsonSchemaDataItemsPersonStatus'
          - type: 'null'
          description: Lifecycle status of the person (worker profile). Omitted or null without people_person_status.view; excluded from the response when using `fields` if not requested.
        work_location:
          type:
          - string
          - 'null'
          description: The work location of the employee.
        direct_manager:
          oneOf:
          - $ref: '#/components/schemas/PeopleGetResponsesContentApplicationJsonSchemaDataItemsDirectManager'
          - type: 'null'
          description

# --- truncated at 32 KB (93 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/deel/refs/heads/main/openapi/deel-subpackage-people-api-openapi.yml