Skip to content

Rippling: List compensations — response body — results item

List compensations: response body, field results / item. Complete fields and constraints for contract 2026-10-28.

API reference · Contract 2026-10-28

SDK schema: List compensations — response body — results item

FieldTypePresenceDescription and constraints
$objectRoot
annual_compensationobjectOptionalThe worker’s annual compensation. This calculation assumes 40-hour work weeks for workers with an hourly wage.
annual_compensation.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
annual_compensation.valueJSONOptional
annual_compensation.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
annual_compensation.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
annual_salary_equivalentobjectOptionalThe worker’s annual salary equivalent, for insurance purposes. It will be equal to the worker’s annual compensation, except for owners that are receiving no cashcompensation.
annual_salary_equivalent.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
annual_salary_equivalent.valueJSONOptional
annual_salary_equivalent.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
annual_salary_equivalent.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
bonus_schedulestringOptionalThe worker’s bonus schedule.
created_atstringRequired within parentRecord creation date
hourly_wageobjectOptionalThe worker’s hourly wage. This calculation assumes 40-hour work weeks for workers with fixed compensation.
hourly_wage.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
hourly_wage.valueJSONOptional
hourly_wage.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
hourly_wage.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
idstringRequired within parentIdentifier field
monthly_compensationobjectOptionalThe worker’s monthly compensation. This calculation assumes 40-hour work weeks for workers with an hourly wage.
monthly_compensation.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
monthly_compensation.valueJSONOptional
monthly_compensation.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
monthly_compensation.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
on_target_commissionobjectOptionalThe worker’s on-target commission.
on_target_commission.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
on_target_commission.valueJSONOptional
on_target_commission.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
on_target_commission.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
payment_termsstringOptionalThe payment terms for an worker’s compensation.
payment_typestringOptionalThe payment type for an worker’s compensation.
relocation_reimbursementobjectOptionalThe worker’s hourly wage. This calculation assumes 40-hour work weeks for workers with fixed compensation.
relocation_reimbursement.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
relocation_reimbursement.valueJSONOptional
relocation_reimbursement.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
relocation_reimbursement.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
salary_effective_datestringOptionalSalary effective date
signing_bonusobjectOptionalThe worker’s signing bonus.
signing_bonus.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
signing_bonus.valueJSONOptional
signing_bonus.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
signing_bonus.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
target_annual_bonusobjectOptionalThe worker’s target annual bonus amount.
target_annual_bonus.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
target_annual_bonus.valueJSONOptional
target_annual_bonus.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
target_annual_bonus.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
target_annual_bonus_percentJSONOptional
target_annual_bonus_percent (anyOf 1)numberAlternativeThe worker’s target annual bonus as a percent of annual compensation.
target_annual_bonus_percent (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
updated_atstringRequired within parentRecord update date
weekly_compensationobjectOptionalThe worker’s weekly compensation. This calculation assumes 40-hour work weeks for workers with an hourly wage.
weekly_compensation.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
weekly_compensation.valueJSONOptional
weekly_compensation.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
weekly_compensation.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
workerModelOptionalExpand Retrieve a specific compensation — response body — worker
worker_idstringOptionalThe worker’s ID.

Referenced models: Retrieve a specific compensation — response body — worker

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.