Skip to content

Rippling: List leave requests — response body — results item

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

API reference · Contract 2026-10-28

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

FieldTypePresenceDescription and constraints
$objectRoot
commentsstringOptionalThe comments associated with the leave request.
created_atstringRequired within parentRecord creation date
days_take_offarrayOptionalThe specific dates taken off and the amount of time taken off for each one.
days_take_off[]ModelEach itemExpand Update a leave request — response body — days take off item
end_datestringRequired within parentThe end date of the leave request.
end_timestringOptionalThe end time of the leave request.
idstringRequired within parentIdentifier field
is_managed_by_external_systembooleanOptionalWhether the leave request is managed by an external system.
leave_event_idstringOptionalThe ID of the leave event associated with the leave request, if any.
leave_policy_idstringOptionalThe ID of the leave policy associated with the leave request, either leave_policy_id or leave_type_id must be provided.
leave_typeModelOptionalExpand Update a leave request — response body — leave type
leave_type_idstringOptionalThe ID of the leave type associated with the leave request, either leave_policy_id or leave_type_id must be provided.
number_of_minutes_requestedJSONOptional
number_of_minutes_requested (anyOf 1)numberAlternativeThe number of minutes requested for the leave request.
number_of_minutes_requested (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
reason_for_leavestringOptionalThe reason for the leave request.
requesterModelOptionalExpand Update a leave request — response body — requester
requester_idstringOptionalThe ID of the worker who requested the leave request.
reviewed_atstringOptionalThe timestamp of when the leave request was reviewed.
reviewerModelOptionalExpand Update a leave request — response body — reviewer
reviewer_idstringOptionalThe ID of the worker who reviewed the leave request.
start_datestringRequired within parentThe start date of the leave request.
start_timestringOptionalThe start time of the leave request.
statusstringRequired within parentThe status of the leave request.
Known values: PENDING, APPROVED, REJECTED, CANCELED
updated_atstringRequired within parentRecord update date
workerModelOptionalExpand Update a leave request — response body — worker
worker_idstringRequired within parentThe ID of the worker associated with the leave request.

Referenced models: Update a leave request — response body — days take off item, Update a leave request — response body — leave type, Update a leave request — response body — requester, Update a leave request — response body — reviewer, Update a leave request — 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.