> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a leave

> Retrieve an existing leave.

Retrieve a single [Leave](/reference/leaves/object) by its ID.

### Parameters

<ParamField path="id" type="string" initialValue="lv_1HPCXADYAhh5k1NMU0r1WUqs" required>
  The ID of the leave to retrieve.
</ParamField>

### Returns

Returns the [Leave](/reference/leaves/object) object if a valid ID was provided. Otherwise, returns
an error.

<ResponseExample>
  ```json Response theme={null}
  {
    "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"
  }
  ```
</ResponseExample>