Deel: Retrieve a single contract — 200 response body — data
Retrieve a single contract: 200 response body, field data. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Retrieve a single contract — 200 response body — data
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
client | JSON | Required within parent | Client details associated with the contract. |
client (anyOf 1) | Model | Alternative | Expand Retrieve a single contract — 200 response body — data client Client details associated with the contract |
client (anyOf 2) | null | Alternative | |
compensation_details | Model | Optional | Expand Add external Id — 200 response body — compensation details Compensation and payment configuration for the contract. |
contract_template | JSON | Optional | Contract template details. |
contract_template (anyOf 1) | Model | Alternative | Expand Add external Id — 200 response body — contract template Contract template details |
contract_template (anyOf 2) | null | Alternative | |
cost_centers | array | Optional | List of cost centers associated with the contract. |
cost_centers[] | Model | Each item | Expand Add external Id — 200 response body — cost centers item |
created_at | string | Required within parent | Date and time when the contract was created. Format: date-time |
custom_fields | JSON | Optional | |
custom_fields (anyOf 1) | array | Alternative | List of custom fields attached to the contract. |
custom_fields (anyOf 1)[] | Model | Each item | Expand Retrieve a single contract — 200 response body — data custom fields List of custom fields attached to the contract item |
custom_fields (anyOf 2) | null | Alternative | List of custom fields attached to the contract. |
custom_fields (anyOf 2)[] | Model | Each item | Expand Retrieve a single contract — 200 response body — data custom fields List of custom fields attached to the contract item |
division | JSON | Optional | |
division (anyOf 1) | string | Alternative | Division the worker belongs to, from the active job information of a Global Payroll contract. Null for other contract types or when no division is set. |
division (anyOf 2) | null | Alternative | Division the worker belongs to, from the active job information of a Global Payroll contract. Null for other contract types or when no division is set. |
employment_details | Model | Optional | Expand Retrieve a single contract — 200 response body — data employment details Employment-related details for the contract. |
employment_type | JSON | Optional | Type of employment. |
employment_type (anyOf 1) | string | Alternative | Type of employment. Known values: FULL_TIME, PART_TIME |
employment_type (anyOf 2) | null | Alternative | |
external_id | JSON | Optional | |
external_id (anyOf 1) | string | Alternative | External identifier of the contract. |
external_id (anyOf 2) | null | Alternative | External identifier of the contract. |
fte_percentage | JSON | Optional | |
fte_percentage (anyOf 1) | JSON | Alternative | |
fte_percentage (anyOf 1) (anyOf 1) | number | Alternative | Full time percentage Format: double |
fte_percentage (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
fte_percentage (anyOf 2) | null | Alternative | Full time percentage Format: double |
id | string | Required within parent | Unique identifier for the contract. Minimum length: 1 |
invitations | Model | Required within parent | Expand Add external Id — 200 response body — invitations Invitation email addresses for signing the contract. |
is_archived | JSON | Required within parent | |
is_archived (anyOf 1) | boolean | Alternative | Flag to indicate if the contract is archived. |
is_archived (anyOf 2) | null | Alternative | Flag to indicate if the contract is archived. |
job_title | string | Optional | Job title associated with the contract. |
location | JSON | Optional | |
location (anyOf 1) | string | Alternative | Location name associated with the contract. |
location (anyOf 2) | null | Alternative | Location name associated with the contract. |
notice_period | JSON | Optional | |
notice_period (anyOf 1) | JSON | Alternative | |
notice_period (anyOf 1) (anyOf 1) | number | Alternative | Notice period in days. Format: double |
notice_period (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
notice_period (anyOf 2) | null | Alternative | Notice period in days. Format: double |
platform_payment_type | string | Optional | Whether the contract is paid through Deel (`STANDARD`) or outside Deel (`OFF_PLATFORM`). Applies to IC contracts only. Known values: STANDARD, OFF_PLATFORM |
product_area | JSON | Optional | |
product_area (anyOf 1) | JSON | Alternative | |
product_area (anyOf 1) (anyOf 1) | number | Alternative | Product area code associated with the contract. Format: double |
product_area (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
product_area (anyOf 2) | null | Alternative | Product area code associated with the contract. Format: double |
quote | Model | Optional | Expand Add external Id — 200 response body — quote EOR quote approved by Deel. |
scope_of_work | JSON | Optional | |
scope_of_work (anyOf 1) | string | Alternative | Scope of work of the contract. |
scope_of_work (anyOf 2) | null | Alternative | Scope of work of the contract. |
seniority | JSON | Optional | Seniority describes level of expertise at a job e.g. junior. |
seniority (anyOf 1) | Model | Alternative | Expand Add external Id — 200 response body — seniority id, level, name |
seniority (anyOf 2) | null | Alternative | |
signatures | Model | Required within parent | Expand Add external Id — 200 response body — signatures Signature information for the contract parties. |
special_clause | JSON | Required within parent | |
special_clause (anyOf 1) | string | Alternative | Special clause of the contract. |
special_clause (anyOf 2) | null | Alternative | Special clause of the contract. |
start_date | string | Required within parent | Date and time when the contract starts. Format: date-time |
status | Model | Required within parent | Expand Add external Id — 200 response body — status Status of a contract in Deel workflow. |
termination_date | JSON | Required within parent | |
termination_date (anyOf 1) | string | Alternative | Date and time when the contract ends. |
termination_date (anyOf 2) | null | Alternative | Date and time when the contract ends. |
title | string | Required within parent | Title of the contract. Minimum length: 1 |
type | string | Required within parent | Type of a contract. Known values: ongoing_time_based, milestones, time_based, pay_as_you_go_time_based, commission, payg_milestones, payg_tasks, contractor_outside_deel, eor, unknown, employee, global_payroll, shield_msa, hris_direct_employee, peo |
updated_at | string | Required within parent | Date and time when the contract was updated. Format: date-time |
who_reports | string | Optional | Who reports the hours. |
work_schedule | JSON | Optional | Defines a work schedule including working days, hours, and employment details |
work_schedule (anyOf 1) | Model | Alternative | Expand Retrieve a single contract — 200 response body — data work schedule country, days, effective from, employment type, name, work hours per week, work schedule type, worker types |
work_schedule (anyOf 2) | null | Alternative | |
work_statement_id | JSON | Optional | |
work_statement_id (anyOf 1) | string | Alternative | The unique identifier of the associated work statement. |
work_statement_id (anyOf 2) | null | Alternative | The unique identifier of the associated work statement. |
worker | JSON | Required within parent | Worker details associated with the contract. |
worker (anyOf 1) | Model | Alternative | Expand Retrieve a single contract — 200 response body — data worker Worker details associated with the contract |
worker (anyOf 2) | null | Alternative |
Referenced models: Add external Id — 200 response body — contract template Contract template details, Retrieve a single contract — 200 response body — data client Client details associated with the contract, Add external Id — 200 response body — compensation details, Add external Id — 200 response body — cost centers item, Retrieve a single contract — 200 response body — data custom fields List of custom fields attached to the contract item, Retrieve a single contract — 200 response body — data employment details, Add external Id — 200 response body — invitations, Add external Id — 200 response body — quote, Add external Id — 200 response body — seniority id, level, name, Add external Id — 200 response body — signatures, Add external Id — 200 response body — status, Retrieve a single contract — 200 response body — data work schedule country, days, effective from, employment type, name, work hours per week, work schedule type, worker types, Retrieve a single contract — 200 response body — data worker Worker details associated with the contract