Skip to content

Rippling: List leave balances — response body — results item

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

API reference · Contract 2026-10-28

SDK schema: List leave balances — response body — results item

FieldTypePresenceDescription and constraints
$objectRoot
balance_excluding_future_requestsJSONOptional
balance_excluding_future_requests (anyOf 1)numberAlternativeThe worker’s leave balance excluding future leave requests. If the leave balance is unlimited, this field will be null.
balance_excluding_future_requests (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
balance_excluding_future_requests_in_daysJSONOptional
balance_excluding_future_requests_in_days (anyOf 1)numberAlternativeThe worker’s leave balance in days excluding future leave requests. If the leave balance is unlimited, this field will be null.
balance_excluding_future_requests_in_days (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
balance_including_future_requestsJSONOptional
balance_including_future_requests (anyOf 1)numberAlternativeThe worker’s leave balance including future leave requests. If the leave balance is unlimited, this field will be null.
balance_including_future_requests (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
balance_including_future_requests_in_daysJSONOptional
balance_including_future_requests_in_days (anyOf 1)numberAlternativeThe worker’s leave balance in days including future leave requests. If the leave balance is unlimited, this field will be null.
balance_including_future_requests_in_days (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
created_atstringRequired within parentRecord creation date
idstringRequired within parentIdentifier field
is_balance_unlimitedbooleanOptionalIndicates if the leave balance is unlimited.
leave_typeModelOptionalExpand Retrieve a specific leave balance — response body — leave type
leave_type_idstringOptionalThe ID of the leave type associated with the leave balance.
updated_atstringRequired within parentRecord update date
workerModelOptionalExpand Retrieve a specific leave balance — response body — worker
worker_idstringRequired within parentThe ID of the worker associated with the leave balance.

Referenced models: Retrieve a specific leave balance — response body — leave type, Retrieve a specific leave balance — 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.