Deel: List of contracts — 200 response body — data item
List of contracts: 200 response body, field data / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: List of contracts — 200 response body — data item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
client | Model | Required within parent | Expand List of contracts — 200 response body — data item client Client information associated with the contract. |
cost_centers | array | Optional | List of cost centers associated with the contract. |
cost_centers[] | Model | Each item | Expand List of contracts — 200 response body — data item cost centers item |
created_at | JSON | Required within parent | |
created_at (anyOf 1) | string | Alternative | Timestamp when the contract was created, in ISO-8601 format. Format: date-time |
created_at (anyOf 2) | null | Alternative | Timestamp when the contract was created, in ISO-8601 format. Format: date-time |
custom_fields | JSON | Optional | |
custom_fields (anyOf 1) | array | Alternative | Contract-level custom fields. Only returned when `expand=custom_fields` is provided. |
custom_fields (anyOf 1)[] | Model | Each item | Expand List of contracts — 200 response body — data item custom fields null item |
custom_fields (anyOf 2) | null | Alternative | Contract-level custom fields. Only returned when `expand=custom_fields` is provided. |
custom_fields (anyOf 2)[] | Model | Each item | Expand List of contracts — 200 response body — data item custom fields null item |
external_id | JSON | Optional | |
external_id (anyOf 1) | string | Alternative | A unique identifier for the object provided by an external system. |
external_id (anyOf 2) | null | Alternative | A unique identifier for the object provided by an external system. |
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 | UUID of the contract. Minimum length: 1 |
invitations | Model | Required within parent | Expand List of contracts — 200 response body — data item invitations Details of invitations sent for signing the contract. |
is_archived | boolean | Required within parent | Indicates whether the contract is archived. |
is_shielded | boolean | Required within parent | Indicates whether the contract is shielded. |
notice_period | JSON | Optional | |
notice_period (anyOf 1) | number | Alternative | Number of days required to give notice before terminating the contract. Default: 0 Format: double Minimum: 0 |
notice_period (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
scale | JSON | Optional | |
scale (anyOf 1) | string | Alternative | The payment scale (e.g., hourly, weekly, monthly, etc.). |
scale (anyOf 2) | null | Alternative | The payment scale (e.g., hourly, weekly, monthly, etc.). |
signatures | Model | Required within parent | Expand List of contracts — 200 response body — data item signatures Signature information for the contract. |
status | Model | Required within parent | Expand List of contracts — 200 response body — data item status Status of a contract in Deel workflow. |
termination_date | JSON | Required within parent | |
termination_date (anyOf 1) | string | Alternative | Date when the contract is terminated, in ISO-8601 format. Format: date-time |
termination_date (anyOf 2) | null | Alternative | Date when the contract is terminated, in ISO-8601 format. Format: date-time |
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, eor, unknown, peo, employee, global_payroll, shield_msa, hris_direct_employee, contractor_outside_deel |
who_reports | string | Optional | Indicates who is responsible for providing regular reports. Known values: both, client, contractor |
worker | JSON | Optional | Worker information associated with the contract. |
worker (anyOf 1) | Model | Alternative | Expand List of contracts — 200 response body — data item worker Worker information associated with the contract |
worker (anyOf 2) | null | Alternative |
Referenced models: List of contracts — 200 response body — data item client, List of contracts — 200 response body — data item cost centers item, List of contracts — 200 response body — data item custom fields null item, List of contracts — 200 response body — data item invitations, List of contracts — 200 response body — data item signatures, List of contracts — 200 response body — data item status, List of contracts — 200 response body — data item worker Worker information associated with the contract