Time Off
List leaves
Returns leaves in your Plane workspace.
GET
Use this endpoint when you need leave for scheduling, attendance, or calendar sync use cases.
Results are returned newest first, sorted by
If you send
created and then by id.
Parameters
string
Only return leaves whose end date falls on or after this date. Use an ISO 8601 date such as
2026-04-01.string
Only return leaves whose start date falls on or before this date. Use an ISO 8601 date such as
2026-04-30.string
Only return leaves for this worker ID.
string
Only return leaves in this status. One of
requested, approved, declined, cancelled, or
all. Passing all returns leaves of every status. If you don’t provide a value, only approved
leaves are returned.string
Only return leaves of this type.
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 when any part of it falls inside that date
window.
Request
Returns
Returns a dictionary with aleaves property that contains an array of
Leave objects. If no matching leaves exist, the array is empty.