---
title: "Get a leave request by id"
method: GET
path: "/api/v3/leaveRequests/{id}"
tags: ["Leave Requests"]
---

# Get a leave request by id

`GET /api/v3/leaveRequests/{id}`

Retrieve a single Leave Request by its unique identifier.

## Response `200`

OK

- object
  - `data` 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

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