Deel: Retrieve a single person — 200 response body — data employments item
Retrieve a single person: 200 response body, field data / employments / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Retrieve a single person — 200 response body — data employments item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
client_legal_entity | JSON | Optional | The client legal entity associated with this employment contract. |
client_legal_entity (anyOf 1) | Model | Alternative | Expand Retrieve a single person — 200 response body — data employments item client legal entity id, name |
client_legal_entity (anyOf 2) | null | Alternative | |
completion_date | JSON | Optional | |
completion_date (anyOf 1) | string | Alternative | The completion date of the employment contract. |
completion_date (anyOf 2) | null | Alternative | The completion date of the employment contract. |
contract_coverage | JSON | Optional | The coverage type of the employment contract. ‘is_shielded’ = Contractor of Record, ‘is_premium’ = Premium, null = Standard (no coverage). |
contract_coverage (anyOf 1) | string | Alternative | The coverage type of the employment contract. ‘is_shielded’ = Contractor of Record, ‘is_premium’ = Premium, null = Standard (no coverage). Known values: is_shielded, is_premium |
contract_coverage (anyOf 2) | null | Alternative | |
contract_has_contractor | boolean | Optional | Whether the contract has a contractor. |
contract_is_archived | boolean | Optional | Whether the employment contract is archived. |
contract_status | string | Optional | The status of the employment contract. |
country | JSON | Optional | |
country (anyOf 1) | string | Alternative | The country of employment. |
country (anyOf 2) | null | Alternative | The country of employment. |
email | string | Optional | The work email of the employee. |
has_eor_termination | JSON | Optional | |
has_eor_termination (anyOf 1) | boolean | Alternative | Whether the employment has an EOR termination. |
has_eor_termination (anyOf 2) | null | Alternative | Whether the employment has an EOR termination. |
hiring_status | string | Optional | The current hiring status of the employment. |
hiring_type | string | Optional | The type of hiring of the employment. |
hris_direct_employee_invitation | JSON | Optional | The HRIS direct employee invitation status. |
hris_direct_employee_invitation (anyOf 1) | Model | Alternative | Expand Retrieve a single person — 200 response body — data employments item hris direct employee invitation The HRIS direct employee invitation status |
hris_direct_employee_invitation (anyOf 2) | null | Alternative | |
id | string | Optional | Unique identifier for the employment. |
is_ended | boolean | Optional | Whether the employment has ended. |
is_user_contract_deleted | boolean | Optional | Whether the user contract is deleted. |
job_title | JSON | Optional | |
job_title (anyOf 1) | string | Alternative | The job title of the employment. |
job_title (anyOf 2) | null | Alternative | The job title of the employment. |
name | string | Optional | Name of the employee. |
new_hiring_status | string | Optional | The new hiring status of the employment. |
payment | Model | Optional | Expand Retrieve a single person — 200 response body — data employments item payment Payment information for the employment, including rate, scale, currency, and associated contract name. |
seniority | JSON | Optional | |
seniority (anyOf 1) | string | Alternative | The seniority level of the employment. |
seniority (anyOf 2) | null | Alternative | The seniority level of the employment. |
start_date | JSON | Optional | |
start_date (anyOf 1) | string | Alternative | The start date of the employment. Format: date |
start_date (anyOf 2) | null | Alternative | The start date of the employment. Format: date |
state | JSON | Optional | |
state (anyOf 1) | string | Alternative | The state of employment. |
state (anyOf 2) | null | Alternative | The state of employment. |
team | Model | Optional | Expand Retrieve a single person — 200 response body — data employments item team The team to which the employee belongs. |
termination_last_day | JSON | Optional | |
termination_last_day (anyOf 1) | string | Alternative | The last day of work mentioned on the contract termination. Format: date-time |
termination_last_day (anyOf 2) | null | Alternative | The last day of work mentioned on the contract termination. Format: date-time |
timezone | JSON | Optional | |
timezone (anyOf 1) | string | Alternative | The timezone of the employment. |
timezone (anyOf 2) | null | Alternative | The timezone of the employment. |
voluntarily_left | JSON | Optional | |
voluntarily_left (anyOf 1) | boolean | Alternative | Whether the employee voluntarily left the employment. |
voluntarily_left (anyOf 2) | null | Alternative | Whether the employee voluntarily left the employment. |
work_email | JSON | Optional | |
work_email (anyOf 1) | string | Alternative | The work email of the employment. |
work_email (anyOf 2) | null | Alternative | The work email of the employment. |
Referenced models: Retrieve a single person — 200 response body — data employments item client legal entity id, name, Retrieve a single person — 200 response body — data employments item hris direct employee invitation The HRIS direct employee invitation status, Retrieve a single person — 200 response body — data employments item team, Retrieve a single person — 200 response body — data employments item payment