Skip to content

Rippling: GET Leave Balance — response body — balances Leave balances object

GET Leave Balance: response body, field balances / Leave balances object. Complete fields and constraints for contract 2026-10-28.

API reference · Contract 2026-10-28

SDK schema: GET Leave Balance — response body — balances Leave balances object

FieldTypePresenceDescription and constraints
$objectRootLeave balances object
stringOptional
balanceWithFutureRequestsJSONOptional
balanceWithFutureRequests (anyOf 1)numberAlternativeThe remaining balance in minutes for the employee corresponding to the company leave type with future leave requests considered.
balanceWithFutureRequests (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
balanceWithoutFutureRequestsJSONOptional
balanceWithoutFutureRequests (anyOf 1)numberAlternativeThe remaining balance in minutes for the employee corresponding to the company leave type with future leave requests not considered.
balanceWithoutFutureRequests (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
companyLeaveTypestringOptionalThis is the unique role ID of the company leave types. Corresponds to the ids in response of GET Company Leave Types
isBalanceUnlimitedbooleanOptionaltrue if employee’s balance corresponding to the company leave type is unlimited, else false

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.