---
title: "List pending leave requests"
method: GET
path: "/leave_requests/pending"
tags: ["Leaves"]
---

# List pending leave requests

`GET /leave_requests/pending`

Returns a list of pending leave requests

## Query parameters

- `page` integer

## Response `200`

OK

- object
  - `data` LeaveRequest[]
    - `id` integer, required
    - `employee_id` integer, required
    - `employee` EmployeeShort — Employee short details
      - `id` integer, required
      - `first_name` string
      - `last_name` string
      - `email` string
    - `leave_type_id` integer
    - `leave_type` string, required
    - `state` 'pending' | 'approved' | 'rejected' | 'withdrawn', required
    - `amount` number, required
    - `tracking_time_in` 'hours' | 'days', required
    - `on_demand` boolean
    - `ends_on` string, date, required
    - `starts_on` string, date, required
    - `comment` string
    - `attachment_url` string — **Deprecated**: URL to attachement if provided to the leave request. This URL is temporary and will expire automatically.
    - `attachments` object[]
      - `filename` string
      - `url` string
      - `expires_at` string, date-time — Expiration of the attachment URL
    - `entries` object[]
      - `date` string, date, required
      - `amount` number, required
      - `starts_at` string, date-time
      - `ends_at` string, date-time
    - `approvals` object[]
      - `state` string
      - `assigned_to` object
        - `id` integer
        - `full_name` string
    - `leave_type_policy` object
      - `name` string, required
      - `visibility` 'private' | 'public', required
      - `activity_type` 'not_working_paid' | 'not_working_unpaid' | 'working_paid', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `metadata` Pagination
    - `page` integer
    - `pages` integer
    - `count` integer
    - `items` integer

---

[API](https://skmtc.net/peopleforce/apis/company-api.md) · [All operations](https://skmtc.net/peopleforce/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peopleforce/company-api/revisions/ff612e61a4c3/schema)