Skip to main content
GET
/
v1
/
leaves
/
{id}
Get a leave
curl --request GET \
  --url https://api.plane.com/v1/leaves/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "lv_1HPCXADYAhh5k1NMU0r1WUqs",
  "status": "approved",
  "type": "vacation",
  "worker": "wr_CgcLakmx4guire",
  "starts": "2026-04-14",
  "ends": "2026-04-16",
  "days": 2.5,
  "hours": 20,
  "schedule": {
    "2026-04-14": 8,
    "2026-04-15": 8,
    "2026-04-16": 4
  },
  "note": "Annual vacation",
  "request": {
    "id": "lvr_6r3wLwX44s0Ak0bDkP5n2r7Q",
    "status": "approved",
    "created": "2026-03-10T18:42:11Z",
    "updated": "2026-03-11T09:05:52Z"
  },
  "created": "2026-03-10T18:42:11Z",
  "updated": "2026-03-11T09:05:52Z"
}
Retrieve a single Leave by its ID.

​
Parameters

​
id
string
required
The ID of the leave to retrieve.

​
Returns

Returns the Leave object if a valid ID was provided. Otherwise, returns an error. 
{
  "id": "lv_1HPCXADYAhh5k1NMU0r1WUqs",
  "status": "approved",
  "type": "vacation",
  "worker": "wr_CgcLakmx4guire",
  "starts": "2026-04-14",
  "ends": "2026-04-16",
  "days": 2.5,
  "hours": 20,
  "schedule": {
    "2026-04-14": 8,
    "2026-04-15": 8,
    "2026-04-16": 4
  },
  "note": "Annual vacation",
  "request": {
    "id": "lvr_6r3wLwX44s0Ak0bDkP5n2r7Q",
    "status": "approved",
    "created": "2026-03-10T18:42:11Z",
    "updated": "2026-03-11T09:05:52Z"
  },
  "created": "2026-03-10T18:42:11Z",
  "updated": "2026-03-11T09:05:52Z"
}