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

API reference · Contract 2026-10-27

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

Field	Type	Presence	Description and constraints
$	object	Root	Time off request validation result
amount	string	Optional	The amount of time off requested.
amount_next_tracking_period	string	Optional	The amount of time off requested to be applicable in the next tracking period.
country_specific_validation_results	array	Optional	Results of country-specific validation rules
country_specific_validation_results[]	Model	Each item	Expand Validate time-off request — 200 response body — data country specific validation results item
country_specific_validation_results_next_tracking_period	array	Optional	Results of country-specific validation rules
country_specific_validation_results_next_tracking_period[]	Model	Each item	Expand Validate time-off request — 200 response body — data country specific validation results item
custom_field_validation_results	array	Optional	Every rejected custom field answer. Omitted when all answers are valid.
custom_field_validation_results[]	Model	Each item	Expand Validate time-off request — 200 response body — data custom field validation results item
custom_fields	array	Optional	The custom fields the request policy declares. Omitted when the policy declares none.
custom_fields[]	Model	Each item	Expand Validate time-off request — 200 response body — data custom fields item
dates	array	Optional	The dates breakdown for the time off request.
dates[]	Model	Each item	Expand Validate time-off request — 200 response body — data dates item
event_details_fields	Model	Optional	Expand Validate time-off request — 200 response body — data event details fields Fields required for specific time off requests, such as parental leave.
is_event_based	boolean	Optional	Indicates if the time off request is event-based, such as parental leave
is_valid	boolean	Required within parent	Indicates if the time off request is valid or not. When false, the response will contain an error message.
max_time_off_percentage	string	Optional	The maximum time off percentage allowed for the request
new_end_date	string	Optional	The new end date for the time off request. It could be different from the original end date depending on the policy configuration. For example, for forfait-jour policies Format: date
new_start_date	string	Optional	The new start date for the time off request. It could be different from the original start date depending on the policy configuration. For example, for forfait-jour policies Format: date
remaining_balance	string	Optional	The remaining policy balance for the tracking period
remaining_balance_next_tracking_period	string	Optional	The remaining policy balance for the next tracking period
require_attachment	boolean	Optional	Indicates if an attachment is required for the time off request
require_description	boolean	Optional	Indicates if a description is required for the time off request
validation_error_message	string	Optional	Error message when the time off request is invalid

Referenced models: Validate time-off request — 200 response body — data custom fields item, Validate time-off request — 200 response body — data country specific validation results item, Validate time-off request — 200 response body — data custom field validation results item, Validate time-off request — 200 response body — data dates item, Validate time-off request — 200 response body — data event details fields