---
title: "List leave requests"
method: GET
path: "/api/v3/leaveRequests"
tags: ["Leave Requests"]
---

# List leave requests

`GET /api/v3/leaveRequests`

Retrieve a list of Leave Requests.

## Response `200`

OK

- object
  - `data` object
    - `items` LeaveRequest[]
      - `id` integer — Unique identifier for the LeaveRequest
      - `leavePeriodId` integer — Unique identifier for the attached LeavePeriod
      - `leavePeriod` LeavePeriod
        - `id` number — Unique identifier for the LeavePeriod
        - `ownerId` number — Unique identifier for the user
        - `isConfirmed` boolean — Has the value `true` for approved LeavePeriod or the value `false` for LeavePeriod pending approval
        - `confirmationDate` string, date-time, nullable — Time at which the LeavePeriod was approved
        - `attachmentId` string, nullable — Unique identifier for the attached document
        - `leaves` object[]
        - `logs` LeavePeriodLog[]
          - `id` integer
          - `date` string, date-time
          - `comment` string
          - `status` 0 | 2 | 3 | 4 | 5 — - 0 = PENDING_APPROVAL - 2 = APPROVED - 3 = DENIED - 4 = CANCELLED - 5 = CANCELLATION_PENDING
      - `status` 0 | 2 | 3 | 4 | 5 — Status of the Leave request. Can be : 0 = PENDING_APPROVAL 2 = APPROVED 3 = DENIED 4 = CANCELLED 5 = CANCELLATION_PENDING
      - `creationDate` string, date-time — Time at which the object was created
      - `nextApproverId` integer, nullable — Unique identifier for the next approver
      - `cancellationUserId` integer, nullable — Unique identifier for the user that cancelled the Leave Request
      - `cancellationDate` string, date-time, nullable — Time at which the object was cancelled
      - `isActive` boolean — Has the value `true` for acitve Leave Request or the value `false` for cancelled Leave Request
      - `approvals` LeaveRequestApproval[]
        - `id` integer — Unique identifier for the LeaveRequestApproval
        - `date` string, date-time
        - `approverId` number — Unique identifier for the approver
        - `substitutedApproverId` 0 | 2 | 3 | 4 | 5, nullable — 0 = PENDING_APPROVAL 2 = APPROVED 3 = DENIED 4 = CANCELLED 5 = CANCELLATION_PENDING
        - `approved` boolean — Has the value `true` for approved LeaveRequest or the value `false` for LeaveRequest pending approval
        - `comment` string — Comments
      - `cancellationRequests` CancellationRequest[]
        - `id` integer
        - `authorId` integer
        - `comment` string
        - `rank` 0 | 2 | 3 | 4 | 5 — 0 = PENDING_APPROVAL 2 = APPROVED 3 = DENIED 4 = CANCELLED 5 = CANCELLATION_PENDING
        - `approved` boolean
        - `creationDate` string, date-time
        - `nextApproverId` number, nullable
        - `isActive` boolean
    - `count` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/luccasoftware/apis/lucca-expenses.md) · [All operations](https://skmtc.net/luccasoftware/apis/lucca-expenses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luccasoftware/lucca-expenses/revisions/110f9897756c/schema)