Skip to content

Deel: List time-off requests for Organization — 200 response body — data item

List time-off requests for Organization: 200 response body, field data / item. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: List time-off requests for Organization — 200 response body — data item

FieldTypePresenceDescription and constraints
$objectRoot
amountstringRequired within parentAmount of time off
approved_atJSONOptional
approved_at (anyOf 1)stringAlternativeTime off approval date
Format: date-time
approved_at (anyOf 2)nullAlternativeTime off approval date
Format: date-time
canceled_atJSONOptional
canceled_at (anyOf 1)stringAlternativeTime off cancellation date
Format: date-time
canceled_at (anyOf 2)nullAlternativeTime off cancellation date
Format: date-time
contract_oidstringOptionalContract id
created_atstringRequired within parentTime off creation date
Format: date-time
custom_field_valuesarrayOptionalAnswers to the custom fields the request policy declares. Omitted when the policy declares none.
custom_field_values[]ModelEach itemExpand Update time-off request — 200 response body — time off custom field values item
deduction_amountJSONOptional
deduction_amount (anyOf 1)stringAlternativeDeduction amount
deduction_amount (anyOf 2)nullAlternativeDeduction amount
deleted_atJSONOptional
deleted_at (anyOf 1)stringAlternativeTime off deletion date. Present only when the time-off is soft-deleted and include_deleted_time_offs was requested.
Format: date-time
deleted_at (anyOf 2)nullAlternativeTime off deletion date. Present only when the time-off is soft-deleted and include_deleted_time_offs was requested.
Format: date-time
descriptionJSONOptional
description (anyOf 1)stringAlternativeTime off description
description (anyOf 2)nullAlternativeTime off description
end_datestringRequired within parentEnd date of time off
Format: date
entitlement_unitstringRequired within parentThe unit in which the time off usage and entitlement are calculated.
Known values: HOUR, BUSINESS_DAY, CALENDAR_DAY, WEEK, MONTH, YEAR
half_end_datebooleanRequired within parentIs half end date
half_start_datebooleanRequired within parentIs half start date
idstringRequired within parentTime off id
Format: uuid
is_end_date_estimatedbooleanOptionalIs end date estimated
is_paidbooleanRequired within parentIs time off paid
other_type_descriptionJSONOptional
other_type_description (anyOf 1)stringAlternativeOther type description
other_type_description (anyOf 2)nullAlternativeOther type description
reasonstringOptionalReason for time off
recipient_profileModelOptionalExpand List time-off requests — 200 response body — data item recipient profile
requested_atstringRequired within parentTime off request date
Format: date
requester_profileModelOptionalExpand List time-off requests — 200 response body — data item requester profile
start_datestringRequired within parentStart date of time off
Format: date
statusstringOptionalStatus of time off
Known values: REQUESTED, APPROVED, REJECTED, USED, CANCELED, DELETED
time_off_dailiesarrayOptional
time_off_dailies[]ModelEach itemExpand List time-off requests — 200 response body — data item time off dailies item
time_off_originstringOptionalTime off origin. AUTO_BANK_HOLIDAY is a bank holiday request that the system books for the worker.
Known values: ADMIN, BULK_IMPORT, DEEL_APP, ENGAGE, INTEGRATION, PUBLIC_API, SLACK, TEAMS, AUTO_BANK_HOLIDAY, UNKNOWN
time_off_percentageJSONOptional
time_off_percentage (anyOf 1)stringAlternativeTime off percentage
time_off_percentage (anyOf 2)nullAlternativeTime off percentage
time_off_typeModelOptionalExpand List time-off requests for Organization — 200 response body — data item time off type
time_off_type_idstringRequired within parentTime off type id
updated_atstringRequired within parentTime off update date
Format: date-time

Referenced models: Update time-off request — 200 response body — time off custom field values item, List time-off requests — 200 response body — data item recipient profile, List time-off requests — 200 response body — data item requester profile, List time-off requests — 200 response body — data item time off dailies item, List time-off requests for Organization — 200 response body — data item time off type

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.