---
title: "Retrieve time off details by ID"
method: GET
path: "/v1/timeoffs/{timeOffId}"
tags: ["Time Offs"]
---

# Retrieve time off details by ID

`GET /v1/timeoffs/{timeOffId}`

Get detailed information about a specific time off request by its unique identifier.

This endpoint allows you to:
- Retrieve complete details of a time off request
- View the current status and approval state
- Access time off dates, duration, and description
- See time off type information

## Path parameters

- `timeOffId` string, required

## Response `200`

Time off details retrieved successfully

- V1TimeoffsTimeOffIdGetResponse
  - `timeOffId` string, uuid, required — Unique identifier for the time off
  - `status` 'DRAFT' | 'APPROVAL_IN_PROGRESS' | 'APPROVED' | 'REJECTED' | 'TAKEN' | 'DELETED' | 'REVOKED', required — Current status of the time off request
  - `startDate` TimeOffDate, required
    - `date` string, date — Date in YYYY-MM-DD format
    - `session` 'MORNING' | 'AFTERNOON' | 'FULL_DAY' — Session of the day
  - `endDate` TimeOffDate, required
    - `date` string, date — Date in YYYY-MM-DD format
    - `session` 'MORNING' | 'AFTERNOON' | 'FULL_DAY' — Session of the day
  - `noOfDays` number, float, required — Number of days for the time off (calculated)
  - `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

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required
- `403` — Forbidden - insufficient permissions
- `404` — Resource not found
- `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)