> ## 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.

# Leave Request

> Leave requests represent a worker's time-off requests

Use leave requests when you need workflow details about submitted, approved, declined, or cancelled
time-off requests. A worker can have more than one leave request for the same
[Leave](/reference/leaves/object) over time.

### Attributes

<ResponseField name="id" type="string">
  Unique identifier for the leave request, for example `lvr_6r3wLwX44s0Ak0bDkP5n2r7Q`.
</ResponseField>

<ResponseField name="status" type="string">
  Current request status. One of `requested`, `approved`, `declined`, or `cancelled`.
</ResponseField>

<ResponseField name="leave" type="object">
  Summary of the leave attached to this request.

  <Expandable title="child attributes">
    <ResponseField name="id" type="string">
      The ID of the leave, for example `lv_1HPCXADYAhh5k1NMU0r1WUqs`.
    </ResponseField>

    <ResponseField name="type" type="string">
      Type of leave.
    </ResponseField>

    <ResponseField name="worker" type="string">
      The ID of the worker the leave belongs to.
    </ResponseField>

    <ResponseField name="starts" type="string">
      First day of the leave, formatted as an ISO 8601 date.
    </ResponseField>

    <ResponseField name="ends" type="string">
      Last day of the leave, formatted as an ISO 8601 date.
    </ResponseField>

    <ResponseField name="days" type="number">
      Total number of leave days. This value can be fractional.
    </ResponseField>

    <ResponseField name="hours" type="number">
      Total number of leave hours.
    </ResponseField>

    <ResponseField name="schedule" type="object">
      Dictionary of ISO 8601 dates to hours for each day in the leave, for example
      `{ "2026-04-14": 8, "2026-04-15": 8, "2026-04-16": 4 }`.
    </ResponseField>

    <ResponseField name="note" type="string | null">
      Optional note submitted with the leave.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created" type="string">
  ISO 8601 timestamp of when the leave request was created.
</ResponseField>

<ResponseField name="updated" type="string">
  ISO 8601 timestamp of the most recent update to this leave request.
</ResponseField>

<ResponseExample>
  ```json Leave Request theme={null}
  {
    "id": "lvr_6r3wLwX44s0Ak0bDkP5n2r7Q",
    "status": "requested",
    "leave": {
      "id": "lv_1HPCXADYAhh5k1NMU0r1WUqs",
      "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"
    },
    "created": "2026-03-10T18:42:11Z",
    "updated": "2026-03-10T18:42:11Z"
  }
  ```
</ResponseExample>