Leave Requests
List leave requests
Returns leave requests in your Plane workspace.
GET
Use this endpoint when you need leave request history, including requests that are still pending or
that were later declined or cancelled. Results are returned newest first, sorted by
If you send
created and
then by id.
Parameters
string
Only return leave requests whose leave end date falls on or after this date. Use an ISO 8601
date such as
2026-04-01.string
Only return leave requests whose leave start date falls on or before this date. Use an ISO 8601
date such as
2026-04-30.string
Only return leave requests in this status. One of
requested, approved, declined, or
cancelled.string
Only return leave requests for this worker ID.
string
Only return leave requests for this leave ID.
number
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the
default is 10.
string
A value from a previous response that lets you fetch the next page.
string
Return results after this object ID.
string
Return results before this object ID.
starts or ends, Plane returns a leave request when any part of its leave falls
inside that date window.
Request
Returns
Returns a dictionary with aleave_requests property that contains an array of
Leave Request objects. If no matching leave requests exist, the
array is empty.