Deel: Validate time-off request — request body — body data

API reference · Contract 2026-10-27

SDK schema: Validate time-off request — request body — body data

Field	Type	Presence	Description and constraints
$	object	Root	Time off request data
custom_field_values	array or null	Optional	Answers to the custom fields the request policy declares, addressed by custom field id.
custom_field_values[]	Model	Each item	Expand Create time-off request — request body — body data custom field values item
dates	array	Optional	The dates breakdown for the time off request.
dates[]	Model	Each item	Expand Validate time-off request — request body — body data dates item
deduction_amount	string	Optional	The amount to be deducted from the time off balance. Only valid for policies used by independent contractors
description	string or null	Optional	The description of the time off request Maximum length: 500
end_date	string	Required within parent	The end date of the time off request. Format: date
event_details	Model	Optional	Expand Validate time-off request — request body — body data event details Event details regarding the leave. Required for event based policies such as parental leave.
id	string	Optional	The time off id. Required when validating a time off update request
is_paid	boolean	Optional	Indicates if the time off request is paid or not. By default it follows the policy configuration.
policy_id	string	Optional	The time off policy id. Can be used in place of time_off_type_id
recipient_profile_id	string	Required within parent	The hris profile id of the recipient
start_date	string	Required within parent	The start date of the time off request. Format: date
time_off_event_id	string	Optional	The time off event id that this request is associated with. Only present for event-based policies such as parental leave.
time_off_percentage	string or null	Optional	The percentage of time off requested. For example, if the request is for a full day, the percentage will be 1. If it’s for half a day, the percentage will be 0.5.
time_off_type_id	string	Optional	The time off type id. Required when policy_id is not provided

Referenced models: Create time-off request — request body — body data custom field values item, Validate time-off request — request body — body data dates item, Validate time-off request — request body — body data event details