How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Deel subpackage_people API

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

Deel subpackage_people API is one of 91 APIs that Deel publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

This API exposes 6 operations across 5 paths, and defines 95 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.letsdeel.com/rest/v2, https://api-staging.letsdeel.com/rest/v2.

6 operations 5 paths 95 schemas 3 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Servers
https://api.letsdeel.com/rest/v2
https://api-staging.letsdeel.com/rest/v2
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Deel subpackage_people API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (deelToken). It accepts HTTP bearer tokens (oauth2).

  • deelToken — Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authenticatio…
  • oauth2 — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Paths & Operations 6

Across 5 paths, the API surfaces 6 operations — 3 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

subpackage_people 6
POST
/pwac
Create a person without a contract
create-person-without-contract 1 param body → 201400401403404500
GET
/people
List of People
get-people 14 params → 200400401403404500
POST
/people
Create a direct employee
create-a-direct-employee 1 param body → 201400401403404500
GET
/people/{hris_profile_id}
Retrieve a single person
get-person-by-id 4 params → 200400401403404500
PUT
/people/{id}/working-location
Update working location
update-person-working-location 2 params body → 200400401403404500
GET
/people/me
Get my current personal profile
get-my-current-personal-profile 1 param → 200400401403404500

Schemas 95

The contract defines 95 schemas that model the data the API accepts and returns. The most detailed are PeopleGetResponsesContentApplicationJsonSchemaDataItems (36 properties), PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaData (35 properties), PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmploymentsItems (30 properties), PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmploymentsItems (27 properties). Each schema is shown below with its type and property counts.

people_updatePersonWorkingLocation_Response_200
object
1 property 1 required
PwacPostRequestBodyContentApplicationJsonSchemaDataClientLegalEntity
object
1 property 1 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataDepartment
object
The department of the employee.
3 properties
PeoplePostResponsesContentApplicationJsonSchemaDataEmployee
object
The person that is being hired
6 properties 4 required
PwacPostRequestBodyContentApplicationJsonSchemaDataInvitation
object
Optional invitation configuration for the new hire. Defaults to 'disable' if not provided.
1 property
PeopleGetResponsesContentApplicationJsonSchemaDataItemsDirectReportsItems
object
4 properties
PeoplePostResponsesContentApplicationJsonSchemaDataEmployment
object
The employment details of the employee
8 properties 7 required
RetrieveASinglePersonRequestInternalServerError
object
1 property 1 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaData
object
35 properties
PeopleGetResponsesContentApplicationJsonSchemaDataItems
object
36 properties
PeopleGetResponsesContentApplicationJsonSchemaError
object
3 properties 2 required
PeopleGetResponsesContentApplicationJsonSchemaDataItemsActiveWorkerTerminationStatus
string
The status of the active worker termination.
PeoplePostRequestBodyContentApplicationJsonSchemaDataEmploymentOneOf0Type
string
The type of employment
People_getMyCurrentPersonalProfile_Response_200
object
People object representing a Deel
18 properties
PeoplePostResponsesContentApplicationJsonSchemaDataCompensationDetailsScale
string
The scale at which the salary is paid
PeopleGetParametersHiringStatusesSchemaItems
string
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataDirectManager
object
The direct manager of the employee.
5 properties
PwacPostRequestBodyContentApplicationJsonSchemaData
object
3 properties 2 required
PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmploymentsItems
object
30 properties
PwacPostResponsesContentApplicationJsonSchemaError
object
2 properties 2 required
PeoplePostRequestBodyContentApplicationJsonSchemaDataClientDepartment
object
The department information for the employee
1 property 1 required
PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmploymentsItemsBandPlacement
string
Where the employee falls in their compensation band
PeopleGetResponsesContentApplicationJsonSchemaDataItemsPersonStatus
string
Lifecycle status of the person (worker profile). Omitted or null without peoplepersonstatus.view; excluded from the response when using fields if not requested.
PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmploymentsItemsClientLegalEntity
object
The client legal entity associated with this employment contract.
2 properties
PeopleGetResponsesContentApplicationJsonSchemaDataItemsDirectManager
object
The direct manager of the employee.
5 properties
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataProfileOrganizationalStructuresItemsTeamsItemsPositionsItems
object
3 properties
PwacPostRequestBodyContentApplicationJsonSchemaDataClient
object
3 properties 2 required
people_createPersonWithoutContract_Response_201
object
1 property 1 required
PeoplePostRequestBodyContentApplicationJsonSchemaDataEmployment
The employment details of the employee
PeoplePostRequestBodyContentApplicationJsonSchemaDataClientTeam
object
The team information for the employee
2 properties 1 required
ApiErrorContainer
object
2 properties
PeoplePostResponsesContentApplicationJsonSchemaError
object
2 properties 2 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmploymentsItemsPaymentRate
The payment rate. Value is a string if contract type is PEO.
PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmploymentsItemsTeam
object
The team to which the employee belongs.
2 properties
PeopleGetResponsesContentApplicationJsonSchemaPage
object
3 properties 3 required
CreateAPersonWithoutAContract-v2026-01-01RequestBadRequestError
object
1 property 1 required
PeopleGetResponsesContentApplicationJsonSchemaDataItemsClientLegalEntity
object
The primary client legal entity associated with the employee.
2 properties
PeopleGetParametersFieldsSchemaItems
string
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataActiveWorkerTerminationStatus
string
The status of the active worker termination.
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataProfileOrganizationalStructuresItems
object
3 properties
PeopleGetParametersHiringTypesSchemaItems
string
PeopleGetParametersSortBy
string
PeopleIdWorkingLocationPutRequestBodyContentApplicationJsonSchemaData
object
1 property 1 required
PeopleMeGetResponsesContentApplicationJsonSchemaProfileType
string
Type of profile
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataDirectReportsItems
object
4 properties
CreateAPersonWithoutAContract-v2026-01-01RequestInternalServerError
object
1 property 1 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmploymentsItemsTeam
object
The team to which the employee belongs.
2 properties
ApiErrorRequest
object
7 properties
PeoplePostRequestBodyContentApplicationJsonSchemaDataEmploymentOneOf1Type
string
The type of employment
PeoplePostRequestBodyContentApplicationJsonSchemaDataClientLegalEntity
object
The legal entity information for the employee
1 property 1 required
People_createADirectEmployee_Response_201
object
1 property 1 required
people_getPeople_Response_200
object
2 properties 1 required
PeopleGetResponsesContentApplicationJsonSchemaDataItemsAddressesItems
object
5 properties
PeoplePostRequestBodyContentApplicationJsonSchemaDataEmployee
object
The person that is being hired
8 properties 5 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmploymentsItemsContractCoverage
string
The coverage type of the employment contract. 'isshielded' = Contractor of Record, 'ispremium' = Premium, null = Standard (no coverage).
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataClientLegalEntity
object
The primary client legal entity associated with the employee.
2 properties
PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmailsItems
object
2 properties
people_getPersonById_Response_200
object
1 property 1 required
CreateADirectEmployeeRequestInternalServerError
object
1 property 1 required
PwacPostRequestBodyContentApplicationJsonSchemaDataPerson
object
The person that is being hired
14 properties 4 required
ApiError
object
2 properties
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmploymentsItemsHrisDirectEmployeeInvitation
object
The HRIS direct employee invitation status.
4 properties
PeoplePostRequestBodyContentApplicationJsonSchemaDataClient
object
The entity that is hiring the employee
3 properties 2 required
PeoplePostRequestBodyContentApplicationJsonSchemaDataEmployment0
object
7 properties 5 required
PeopleGetParametersSortOrder
string
PeopleGetResponsesContentApplicationJsonSchemaDataItemsDepartment
object
The department of the employee.
3 properties
PwacPostRequestBodyContentApplicationJsonSchemaDataInvitationAction
string
Controls whether to send an invitation email.
ListOfPeople-v2026-01-01RequestInternalServerError
object
1 property 1 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmploymentsItemsPayment
object
Payment information for the employment, including rate, scale, currency, and associated contract name.
4 properties
PeoplePostRequestBodyContentApplicationJsonSchemaDataEmployment1
object
6 properties 4 required
PeoplePostRequestBodyContentApplicationJsonSchemaData
object
4 properties 4 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmploymentsItems
object
27 properties
PeopleIdWorkingLocationPutResponsesContentApplicationJsonSchemaData
object
1 property 1 required
PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmploymentsItemsHrisDirectEmployeeInvitation
object
The HRIS direct employee invitation status.
4 properties
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmploymentsItemsClientLegalEntity
object
The client legal entity associated with this employment contract.
2 properties
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataAddressesItems
object
5 properties
PeoplePostResponsesContentApplicationJsonSchemaData
object
4 properties 4 required
PeoplePostRequestBodyContentApplicationJsonSchemaDataCompensationDetails
object
The compensation details of the employee
3 properties 2 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataProfileOrganizationalStructuresItemsTeamsItemsPositionsItemsRole
object
The role associated with this position, including role ID and name.
2 properties
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaError
object
3 properties 2 required
CreateADirectEmployeeRequestBadRequestError
object
1 property 1 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataProfileOrganizationalStructuresItemsTeamsItems
object
4 properties
PwacPostRequestBodyContentApplicationJsonSchemaDataClientTeam
object
3 properties 1 required
PeoplePostRequestBodyContentApplicationJsonSchemaDataCompensationDetailsScale
string
The scale at which the salary is paid
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataEmailsItems
object
2 properties
PeopleGetParametersBandPlacementsSchemaItems
string
PwacPostResponsesContentApplicationJsonSchemaData
object
2 properties 2 required
PeoplePostResponsesContentApplicationJsonSchemaDataCompensationDetails
object
The compensation details of the employee
3 properties 2 required
PwacPostResponsesContentApplicationJsonSchemaDataPerson
object
The person that is being hired
13 properties 4 required
PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmploymentsItemsPayment
object
Payment information for the employment, including rate, scale, currency, and associated contract name.
4 properties
PeopleGetResponsesContentApplicationJsonSchemaDataItemsEmploymentsItemsContractCoverage
string
The coverage of the employment contract.
PwacPostRequestBodyContentApplicationJsonSchemaDataClientDepartment
object
1 property 1 required
PeopleHrisProfileIdGetResponsesContentApplicationJsonSchemaDataCustomFieldsItems
object
Customized attributes on people (Job title, Project code, etc).
2 properties
PeoplePostResponsesContentApplicationJsonSchemaDataEmploymentType
string
The type of employment
PeopleGetParametersPersonStatusesSchemaItems
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

deel-subpackage-people-api-openapi.yml Raw ↑

Other APIs Deel publishes across the network.

Deel Default API
Deel subpackage_accounting API
Deel subpackage_adjustments API
Deel subpackage_assets API
Deel subpackage_ats API
Deel subpackage_candidates API
Deel subpackage_consent API
Deel subpackage_contractorAmendments API
Deel subpackage_contractorHiring API
Deel subpackage_contracts API
Deel subpackage_costCalculator API
Deel subpackage_costCenters API
Where this information came from

This is an independent, third-party profile of Deel subpackage_people API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.