---
title: "List time off requests"
method: GET
path: "/v1/timeoffs"
tags: ["Time Offs"]
---

# List time off requests

`GET /v1/timeoffs`

Search and list time off requests with pagination and filtering capabilities.

This endpoint allows you to:
- Retrieve time off requests for specific employees
- Filter by status (draft, pending approval, approved, etc.)
- Filter by date ranges
- Filter by time off types
- Sort results by various fields
- Paginate through large result sets

## Query parameters

- `page` integer
- `pageSize` integer
- `employeeId` string, uuid
- `status` string[]
- `startDateFrom` string, date
- `startDateTo` string, date
- `typeId` string[]
- `sortBy` 'startDate' | 'createdOn' | 'updatedOn' | 'noOfDays'
- `sortOrder` 'ASC' | 'DESC'

## Response `200`

Time off requests retrieved successfully

- V1TimeoffsGetResponse
  - `timeOffs` TimeOffItem[], required — List of time off requests
    - `timeOffId` string, uuid — Unique identifier for the time off
    - `status` 'DRAFT' | 'APPROVAL_IN_PROGRESS' | 'APPROVED' | 'REJECTED' | 'TAKEN' | 'DELETED' | 'REVOKED' — Status of the time off
    - `startDate` TimeOffDate
      - `date` string, date — Date in YYYY-MM-DD format
      - `session` 'MORNING' | 'AFTERNOON' | 'FULL_DAY' — Session of the day
    - `endDate` TimeOffDate
      - `date` string, date — Date in YYYY-MM-DD format
      - `session` 'MORNING' | 'AFTERNOON' | 'FULL_DAY' — Session of the day
    - `noOfDays` number, float — Number of days for the time off
    - `description` string — Description or reason for the time off
    - `type` TimeOffTypeInfo
      - `typeId` string, uuid — ID of the time off type
      - `key` string — Type key (e.g., 'annual', 'sick')
    - `createdOn` string, date-time — Timestamp when the time off was created
    - `updatedOn` string, date-time — Timestamp when the time off was last updated
  - `page` Pagination, required — Pagination information for list responses
    - `page` integer, required — Current page number (1-based)
    - `pageSize` integer, required — Number of items per page
    - `totalCount` integer, required — Total number of items across all pages
    - `totalPages` integer, required — Total number of pages
  - `allCount` integer — Total count of all time offs (regardless of filters)
  - `pendingCount` integer — Count of time offs pending approval
  - `approvedCount` integer — Count of approved time offs

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required
- `403` — Forbidden - insufficient permissions
- `422` — Unprocessable entity - validation error
- `500` — Internal server error
- `503` — Service unavailable - upstream dependency error

---

[API](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api.md) · [All operations](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usemultiplier/multiplier-public-rest-api/revisions/59cd6443fdbf/schema)