---
title: "Returns historical or upcoming leave applications"
method: GET
path: "/users/leave-applications"
tags: ["Leave Applications"]
---

# Returns historical or upcoming leave applications

`GET /users/leave-applications`

Get upcoming leave applications, starting from today, or historical applications, ending today or earlier

## Query parameters

- `filter` 'upcoming' | 'historical', required

## Response `200`

All leave applications are sorted by the time they have been created in descending order

- object
  - `leaveApplications` LeaveApplication[]
    - `id` string
    - `employeeName` string
    - `leaveReason` string
    - `from` string
    - `to` string
    - `sendDate` string
    - `status` 'PENDING' | 'APPROVED' | 'DENIED'
    - `comment` string
    - `allDay` boolean

## Other responses

- `400` — When invalid filter is applied

---

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