Skip to content

Deel: Retrieve Benefits for Employee — 200 response body — data item benefits item employer contribution

Retrieve Benefits for Employee: 200 response body, field data / item / benefits / item / employer_contribution. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Retrieve Benefits for Employee — 200 response body — data item benefits item employer contribution

FieldTypePresenceDescription and constraints
$objectRootRecurring employer-paid portion for this benefit, same shape as `employee_contribution`. Together with `employee_contribution.amount`, describes how premium or plan cost is split for the modeled period; billed totals for the active cycle may also appear under `enrollment_details`.
amountJSONRequired within parent
amount (anyOf 1)JSONAlternative
amount (anyOf 1) (anyOf 1)numberAlternativeResolved employer contribution in `currency` per `frequency` period.
Format: double
amount (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
amount (anyOf 2)nullAlternativeResolved employer contribution in `currency` per `frequency` period.
Format: double
currencystringRequired within parentISO 4217 currency code for `amount`. Matches the parent contract’s `currency`.
frequencyJSONRequired within parent
frequency (anyOf 1)stringAlternativeCadence at which the employer contribution is applied. Same vocabulary as `employee_contribution.frequency`.
frequency (anyOf 2)nullAlternativeCadence at which the employer contribution is applied. Same vocabulary as `employee_contribution.frequency`.
typeJSONRequired within parent
type (anyOf 1)stringAlternativeHow the employer contribution is derived. FIXED_AMOUNT = flat currency per `frequency`. PERCENTAGE = percent of an earnings or cost basis. Additional values may appear for specialized products.
type (anyOf 2)nullAlternativeHow the employer contribution is derived. FIXED_AMOUNT = flat currency per `frequency`. PERCENTAGE = percent of an earnings or cost basis. Additional values may appear for specialized products.
valueJSONRequired within parentRaw employer contribution input; may be number or string depending on source. Prefer `amount` for calculations and UI.
value (anyOf 1)JSONAlternative
value (anyOf 1) (anyOf 1)ModelAlternativeExpand Retrieve Benefits for Employee — 200 response body — data item benefits item employer contribution value value value
value (anyOf 1) (anyOf 2)nullAlternative
value (anyOf 2)nullAlternative

Referenced models: Retrieve Benefits for Employee — 200 response body — data item benefits item employer contribution value value value

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.