Skip to content

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

FieldTypePresenceDescription and constraints
$objectRoot
client_legal_entityJSONOptionalThe client legal entity associated with this employment contract.
client_legal_entity (anyOf 1)ModelAlternativeExpand Retrieve a single person — 200 response body — data employments item client legal entity id, name
client_legal_entity (anyOf 2)nullAlternative
completion_dateJSONOptional
completion_date (anyOf 1)stringAlternativeThe completion date of the employment contract.
completion_date (anyOf 2)nullAlternativeThe completion date of the employment contract.
contract_coverageJSONOptionalThe coverage type of the employment contract. ‘is_shielded’ = Contractor of Record, ‘is_premium’ = Premium, null = Standard (no coverage).
contract_coverage (anyOf 1)stringAlternativeThe 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)nullAlternative
contract_has_contractorbooleanOptionalWhether the contract has a contractor.
contract_is_archivedbooleanOptionalWhether the employment contract is archived.
contract_statusstringOptionalThe status of the employment contract.
countryJSONOptional
country (anyOf 1)stringAlternativeThe country of employment.
country (anyOf 2)nullAlternativeThe country of employment.
emailstringOptionalThe work email of the employee.
has_eor_terminationJSONOptional
has_eor_termination (anyOf 1)booleanAlternativeWhether the employment has an EOR termination.
has_eor_termination (anyOf 2)nullAlternativeWhether the employment has an EOR termination.
hiring_statusstringOptionalThe current hiring status of the employment.
hiring_typestringOptionalThe type of hiring of the employment.
hris_direct_employee_invitationJSONOptionalThe HRIS direct employee invitation status.
hris_direct_employee_invitation (anyOf 1)ModelAlternativeExpand 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)nullAlternative
idstringOptionalUnique identifier for the employment.
is_endedbooleanOptionalWhether the employment has ended.
is_user_contract_deletedbooleanOptionalWhether the user contract is deleted.
job_titleJSONOptional
job_title (anyOf 1)stringAlternativeThe job title of the employment.
job_title (anyOf 2)nullAlternativeThe job title of the employment.
namestringOptionalName of the employee.
new_hiring_statusstringOptionalThe new hiring status of the employment.
paymentModelOptionalExpand Retrieve a single person — 200 response body — data employments item payment
Payment information for the employment, including rate, scale, currency, and associated contract name.
seniorityJSONOptional
seniority (anyOf 1)stringAlternativeThe seniority level of the employment.
seniority (anyOf 2)nullAlternativeThe seniority level of the employment.
start_dateJSONOptional
start_date (anyOf 1)stringAlternativeThe start date of the employment.
Format: date
start_date (anyOf 2)nullAlternativeThe start date of the employment.
Format: date
stateJSONOptional
state (anyOf 1)stringAlternativeThe state of employment.
state (anyOf 2)nullAlternativeThe state of employment.
teamModelOptionalExpand Retrieve a single person — 200 response body — data employments item team
The team to which the employee belongs.
termination_last_dayJSONOptional
termination_last_day (anyOf 1)stringAlternativeThe last day of work mentioned on the contract termination.
Format: date-time
termination_last_day (anyOf 2)nullAlternativeThe last day of work mentioned on the contract termination.
Format: date-time
timezoneJSONOptional
timezone (anyOf 1)stringAlternativeThe timezone of the employment.
timezone (anyOf 2)nullAlternativeThe timezone of the employment.
voluntarily_leftJSONOptional
voluntarily_left (anyOf 1)booleanAlternativeWhether the employee voluntarily left the employment.
voluntarily_left (anyOf 2)nullAlternativeWhether the employee voluntarily left the employment.
work_emailJSONOptional
work_email (anyOf 1)stringAlternativeThe work email of the employment.
work_email (anyOf 2)nullAlternativeThe 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

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.