Deel: List of People — 200 response body — data item

API reference · Contract 2026-10-27

SDK schema: List of People — 200 response body — data item

Field	Type	Presence	Description and constraints
$	object	Root
active_worker_termination_status	JSON	Optional	The status of the active worker termination.
active_worker_termination_status (anyOf 1)	string	Alternative	The status of the active worker termination. Known values: PENDING, CONTRACT_TERMINATION_DATA_COLLECTED, IN_PROGRESS, COMPLETED, FAILED, CANCELED
active_worker_termination_status (anyOf 2)	null	Alternative
additional_details	JSON	Optional
additional_details (anyOf 1)	array	Alternative	Country-scoped additional employment data points (national IDs, tax IDs, etc.) sourced from hris_employment_eligibility.eligibility_data. Returned only when the caller’s organization has the feature flag enable and the request is not redacting PII.
additional_details (anyOf 1)[]	Model	Each item	Expand Retrieve a single person — 200 response body — data additional details null item
additional_details (anyOf 2)	null	Alternative	Country-scoped additional employment data points (national IDs, tax IDs, etc.) sourced from hris_employment_eligibility.eligibility_data. Returned only when the caller’s organization has the feature flag enable and the request is not redacting PII.
additional_details (anyOf 2)[]	Model	Each item	Expand Retrieve a single person — 200 response body — data additional details null item
addresses	JSON	Optional
addresses (anyOf 1)	array	Alternative	An array of address objects containing the employee’s physical addresses.
addresses (anyOf 1)[]	Model	Each item	Expand List of People — 200 response body — data item addresses null item
addresses (anyOf 2)	null	Alternative	An array of address objects containing the employee’s physical addresses.
addresses (anyOf 2)[]	Model	Each item	Expand List of People — 200 response body — data item addresses null item
birth_date	JSON	Optional
birth_date (anyOf 1)	string	Alternative	The birth date of the employee.
birth_date (anyOf 2)	null	Alternative	The birth date of the employee.
client_legal_entity	Model	Optional	Expand Retrieve a single person — 200 response body — data client legal entity The primary client legal entity associated with the employee.
completion_date	JSON	Optional
completion_date (anyOf 1)	string	Alternative	The completion date of the task or project.
completion_date (anyOf 2)	null	Alternative	The completion date of the task or project.
country	JSON	Optional
country (anyOf 1)	string	Alternative	The country of the employee.
country (anyOf 2)	null	Alternative	The country of the employee.
created_at	string	Optional	The creation timestamp of the employee record. Format: date-time
department	Model	Optional	Expand List of People — 200 response body — data item department The department of the employee.
direct_employee_termination_last_day	string	Optional	The last day of work mentioned on the primary contract termination. Format: date-time
direct_manager	JSON	Optional	The direct manager of the employee.
direct_manager (anyOf 1)	Model	Alternative	Expand List of People — 200 response body — data item direct manager The direct manager of the employee
direct_manager (anyOf 2)	null	Alternative
direct_reports	JSON	Optional
direct_reports (anyOf 1)	array	Alternative	The direct reports to the employee.
direct_reports (anyOf 1)[]	Model	Each item	Expand List of People — 200 response body — data item direct reports The direct reports to the employee item
direct_reports (anyOf 2)	null	Alternative	The direct reports to the employee.
direct_reports (anyOf 2)[]	Model	Each item	Expand List of People — 200 response body — data item direct reports The direct reports to the employee item
direct_reports_count	JSON	Optional
direct_reports_count (anyOf 1)	integer	Alternative	The count of direct reports to the employee.
direct_reports_count (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
emails	JSON	Optional
emails (anyOf 1)	array	Alternative	An array of the employee’s email addresses.
emails (anyOf 1)[]	Model	Each item	Expand List of People — 200 response body — data item emails An array of the employee’s email addresses item
emails (anyOf 2)	null	Alternative	An array of the employee’s email addresses.
emails (anyOf 2)[]	Model	Each item	Expand List of People — 200 response body — data item emails An array of the employee’s email addresses item
employments	JSON	Optional
employments (anyOf 1)	array	Alternative	An array of employment records associated with the employee, including contract details, team information, payment details, and employment status.
employments (anyOf 1)[]	Model	Each item	Expand List of People — 200 response body — data item employments null item
employments (anyOf 2)	null	Alternative	An array of employment records associated with the employee, including contract details, team information, payment details, and employment status.
employments (anyOf 2)[]	Model	Each item	Expand List of People — 200 response body — data item employments null item
external_id	JSON	Optional
external_id (anyOf 1)	string	Alternative	The external ID of the employee.
external_id (anyOf 2)	null	Alternative	The external ID of the employee.
first_name	string	Optional	The first name of the employee.
full_name	string	Optional	The full name of the employee.
hiring_status	string	Optional	The current hiring status of the employee.
hiring_type	JSON	Optional
hiring_type (anyOf 1)	string	Alternative	The type of hiring of the employee.
hiring_type (anyOf 2)	null	Alternative	The type of hiring of the employee.
hris_organization_user_id	JSON	Optional
hris_organization_user_id (anyOf 1)	string	Alternative	HRIS Organization User ID of the employee. Used in products like Deel Engage. Format: uuid
hris_organization_user_id (anyOf 2)	null	Alternative	HRIS Organization User ID of the employee. Used in products like Deel Engage. Format: uuid
id	string	Optional	Unique identifier for the employee.
is_pwac	boolean	Optional	Whether the worker is a Person Without a Contract (PWAC)
job_title	JSON	Optional
job_title (anyOf 1)	string	Alternative	The job title of the employee.
job_title (anyOf 2)	null	Alternative	The job title of the employee.
last_name	JSON	Optional
last_name (anyOf 1)	string	Alternative	The last name of the employee.
last_name (anyOf 2)	null	Alternative	The last name of the employee.
middle_name	JSON	Optional
middle_name (anyOf 1)	string	Alternative	The middle name of the employee.
middle_name (anyOf 2)	null	Alternative	The middle name of the employee.
nationalities	array	Optional	The nationality of the employee.
nationalities[]	string	Each item
new_hiring_status	JSON	Optional
new_hiring_status (anyOf 1)	string	Alternative	The new hiring status of the employee.
new_hiring_status (anyOf 2)	null	Alternative	The new hiring status of the employee.
person_status	JSON	Optional	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.
person_status (anyOf 1)	string	Alternative	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. Known values: ACTIVE, NOT_STARTED, INACTIVE
person_status (anyOf 2)	null	Alternative
preferred_first_name	JSON	Optional
preferred_first_name (anyOf 1)	string	Alternative	The preferred first name of the employee.
preferred_first_name (anyOf 2)	null	Alternative	The preferred first name of the employee.
preferred_last_name	JSON	Optional
preferred_last_name (anyOf 1)	string	Alternative	The preferred last name of the employee.
preferred_last_name (anyOf 2)	null	Alternative	The preferred last name of the employee.
seniority	JSON	Optional
seniority (anyOf 1)	string	Alternative	The seniority level of the employee.
seniority (anyOf 2)	null	Alternative	The seniority level of the employee.
start_date	JSON	Optional
start_date (anyOf 1)	string	Alternative	The date the employee started working. Format: date
start_date (anyOf 2)	null	Alternative	The date the employee started working. Format: date
state	JSON	Optional
state (anyOf 1)	string	Alternative	The state of the employee.
state (anyOf 2)	null	Alternative	The state of the employee.
timezone	JSON	Optional
timezone (anyOf 1)	string	Alternative	The timezone of the employee.
timezone (anyOf 2)	null	Alternative	The timezone of the employee.
updated_at	JSON	Optional
updated_at (anyOf 1)	string	Alternative	Long date-time format following ISO-8601 Format: date-time
updated_at (anyOf 2)	null	Alternative	Long date-time format following ISO-8601 Format: date-time
work_location	JSON	Optional
work_location (anyOf 1)	string	Alternative	The work location of the employee.
work_location (anyOf 2)	null	Alternative	The work location of the employee.
worker_id	string	Optional	The worker ID of the employee.

Referenced models: Retrieve a single person — 200 response body — data additional details null item, List of People — 200 response body — data item addresses null item, Retrieve a single person — 200 response body — data client legal entity, List of People — 200 response body — data item department, List of People — 200 response body — data item direct manager The direct manager of the employee, List of People — 200 response body — data item direct reports The direct reports to the employee item, List of People — 200 response body — data item emails An array of the employee’s email addresses item, List of People — 200 response body — data item employments null item