Skip to content

Deel: List policies — 200 response body — policies item policy allowances item

List policies: 200 response body, field policies / item / policy_allowances / item. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: List policies — 200 response body — policies item policy allowances item

FieldTypePresenceDescription and constraints
$objectRoot
accrual_application_typeJSONRequired within parentType of accrual application. Enum to indicate when accruals will be applied within the accrual cycles.
accrual_application_type (anyOf 1)stringAlternativeType of accrual application. Enum to indicate when accruals will be applied within the accrual cycles.
Known values: BEGIN_OF_CYCLE, END_OF_CYCLE, BEGIN_OF_NEXT_CYCLE
accrual_application_type (anyOf 2)nullAlternative
accrual_typestringRequired within parentType of accrual for the allowance. Determines how/when profiles should earn their entitlement (aka: allowance).
Known values: TIMEFRAME, EVENT, TIME_OFF_IN_LIEU, HOURLY, LUMPSUM, NO_AUTO_ACCRUAL
accrual_unitJSONRequired within parentUnit used for accrual
accrual_unit (anyOf 1)stringAlternativeUnit used for accrual
Known values: HOUR, BUSINESS_DAY, CALENDAR_DAY, WEEK, MONTH, YEAR
accrual_unit (anyOf 2)nullAlternative
accrual_unit_amountJSONRequired within parent
accrual_unit_amount (anyOf 1)JSONAlternative
accrual_unit_amount (anyOf 1) (anyOf 1)numberAlternativeAmount of accrual units
Format: double
accrual_unit_amount (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
accrual_unit_amount (anyOf 2)nullAlternativeAmount of accrual units
Format: double
balance_tracking_flexible_custom_request_amountJSONRequired within parent
balance_tracking_flexible_custom_request_amount (anyOf 1)JSONAlternative
balance_tracking_flexible_custom_request_amount (anyOf 1) (anyOf 1)numberAlternativeAmount for flexible custom request balance tracking. The flexible custom extra amount request of the policy allowance.
Format: double
balance_tracking_flexible_custom_request_amount (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
balance_tracking_flexible_custom_request_amount (anyOf 2)nullAlternativeAmount for flexible custom request balance tracking. The flexible custom extra amount request of the policy allowance.
Format: double
balance_tracking_typeJSONRequired within parentType of balance tracking. Determines how workers can request their time off.
balance_tracking_type (anyOf 1)stringAlternativeType of balance tracking. Determines how workers can request their time off.
Known values: INFLEXIBLE, FLEXIBLE_NO_LIMIT, FLEXIBLE_CUSTOM_AMOUNT, FLEXIBLE_UP_TO_YEARLY_ALLOWANCE
balance_tracking_type (anyOf 2)nullAlternative
enable_bank_holidaysbooleanRequired within parentWhether bank holidays are enabled for this allowance
entitlement_expiration_unitJSONRequired within parentUnit used for entitlement expiration
entitlement_expiration_unit (anyOf 1)stringAlternativeUnit used for entitlement expiration
Known values: HOUR, BUSINESS_DAY, CALENDAR_DAY, WEEK, MONTH, YEAR
entitlement_expiration_unit (anyOf 2)nullAlternative
entitlement_expiration_unit_amountJSONRequired within parent
entitlement_expiration_unit_amount (anyOf 1)JSONAlternative
entitlement_expiration_unit_amount (anyOf 1) (anyOf 1)numberAlternativeAmount of entitlement expiration units
Format: double
entitlement_expiration_unit_amount (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
entitlement_expiration_unit_amount (anyOf 2)nullAlternativeAmount of entitlement expiration units
Format: double
entitlement_start_dateJSONRequired within parent
entitlement_start_date (anyOf 1)stringAlternativeStart date for entitlement
Format: date
entitlement_start_date (anyOf 2)nullAlternativeStart date for entitlement
Format: date
entitlement_start_typestringRequired within parentType of entitlement start
Known values: IMMEDIATELY, FIXED_PERIOD, FIXED_DAY
entitlement_start_unitJSONRequired within parentUnit used for entitlement start
entitlement_start_unit (anyOf 1)stringAlternativeUnit used for entitlement start
Known values: HOUR, BUSINESS_DAY, CALENDAR_DAY, WEEK, MONTH, YEAR
entitlement_start_unit (anyOf 2)nullAlternative
entitlement_start_unit_amountJSONRequired within parent
entitlement_start_unit_amount (anyOf 1)JSONAlternative
entitlement_start_unit_amount (anyOf 1) (anyOf 1)numberAlternativeAmount of entitlement start units
Format: double
entitlement_start_unit_amount (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
entitlement_start_unit_amount (anyOf 2)nullAlternativeAmount of entitlement start units
Format: double
entitlement_unitJSONRequired within parentUnit used for entitlement
entitlement_unit (anyOf 1)stringAlternativeUnit used for entitlement
Known values: HOUR, BUSINESS_DAY, CALENDAR_DAY, WEEK, MONTH, YEAR
entitlement_unit (anyOf 2)nullAlternative
entitlement_unit_amountJSONRequired within parent
entitlement_unit_amount (anyOf 1)JSONAlternative
entitlement_unit_amount (anyOf 1) (anyOf 1)numberAlternativeAmount of entitlement units
Format: double
entitlement_unit_amount (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
entitlement_unit_amount (anyOf 2)nullAlternativeAmount of entitlement units
Format: double
idstringRequired within parentUnique identifier of the policy allowance
Format: uuid
part_time_prorated_entitlement_unit_amountJSONOptional
part_time_prorated_entitlement_unit_amount (anyOf 1)JSONAlternative
part_time_prorated_entitlement_unit_amount (anyOf 1) (anyOf 1)numberAlternativeThe total prorated policy allowance entitlement amount if the worker is part-time.
Format: double
part_time_prorated_entitlement_unit_amount (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
part_time_prorated_entitlement_unit_amount (anyOf 2)nullAlternativeThe total prorated policy allowance entitlement amount if the worker is part-time.
Format: double
rollover_expiration_unitJSONRequired within parentUnit used for rollover expiration
rollover_expiration_unit (anyOf 1)stringAlternativeUnit used for rollover expiration
Known values: HOUR, BUSINESS_DAY, CALENDAR_DAY, WEEK, MONTH, YEAR
rollover_expiration_unit (anyOf 2)nullAlternative
rollover_expiration_unit_amountJSONRequired within parent
rollover_expiration_unit_amount (anyOf 1)JSONAlternative
rollover_expiration_unit_amount (anyOf 1) (anyOf 1)numberAlternativeAmount of rollover expiration units
Format: double
rollover_expiration_unit_amount (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
rollover_expiration_unit_amount (anyOf 2)nullAlternativeAmount of rollover expiration units
Format: double
rollover_limit_unit_amountJSONRequired within parent
rollover_limit_unit_amount (anyOf 1)JSONAlternative
rollover_limit_unit_amount (anyOf 1) (anyOf 1)numberAlternativeAmount of rollover limit units
Format: double
rollover_limit_unit_amount (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
rollover_limit_unit_amount (anyOf 2)nullAlternativeAmount of rollover limit units
Format: double
rollover_typeJSONRequired within parentType of rollover
rollover_type (anyOf 1)stringAlternativeType of rollover
Known values: NO_ROLLOVER, PAY_OUT, CARRY_OVER, CARRY_OVER_PAY_OUT
rollover_type (anyOf 2)nullAlternative
typestringRequired within parentType of the policy allowance
Known values: BASE_ALLOWANCE, ADDITIONAL_ALLOWANCE
zero_out_negative_balances_on_rolloverbooleanRequired within parentWhether negative balances are zeroed out on rollover

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.