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

# List Leaves

> Retrieve a list of leave requests for your company.

This endpoint allows third-party tools (like external calendars or payroll software) to pull all time-off requests.

### Query Parameters

<ParamField query="userId" type="string">
  Filter leave requests by a specific employee's unique User ID.
</ParamField>

<ParamField query="status" type="string">
  Filter by approval status (e.g., `PENDING`, `APPROVED`, `REJECTED`, `CANCELLED`).
</ParamField>

### Response

<ResponseExample>
  ```json theme={null}
  {
    "data": [
      {
        "id": "lv_123...",
        "startDate": "2026-12-20T00:00:00.000Z",
        "endDate": "2026-12-26T23:59:59.999Z",
        "days": 5,
        "reason": "Family vacation",
        "status": "APPROVED",
        "leaveType": {
          "name": "Annual Leave",
          "category": "ANNUAL"
        }
      }
    ]
  }
  ```
</ResponseExample>