---
title: "Retrieve a single Time Off"
method: GET
path: "/v2/timeoff/{id}"
tags: ["TimeOffs"]
---

# Retrieve a single Time Off

`GET /v2/timeoff/{id}`

Retrieves a single Time Off by its ID.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

The requested Time Off.

- ResponseTimeOffV2Dto
  - `id` string — The ID of the time off.
  - `techId` string — The assigned tech ID (prefix `USR-`). Use `-1` to assign to all company techs.
  - `startDate` string, date-time — The time & date when the time off starts.
  - `endDate` string, date-time — The time & date when the time off ends.
  - `status` 'approved' | 'pending' | 'declined' — The status of the time off.
  - `reason` 'Vacation' | 'Sick day' | 'Personal' | 'Company Added' | 'Other' — The reason for the time off.
  - `details` string — Details about the time off.
  - `isAllDay` boolean — Whether the time off is for the entire day.
  - `updatedAt` string, date-time — The date and time the time off was updated.
  - `createdAt` string, date-time — The date and time the time off was created.

## Other responses

- `400` — The provided ID is not a valid time off ID.
- `401` — Missing or invalid authentication token.
- `403` — Access to this time off is not allowed.
- `404` — Time off not found.

---

[API](https://skmtc.net/workiz/apis/developer-api.md) · [All operations](https://skmtc.net/workiz/apis/developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/workiz/developer-api/revisions/14666f4db0f8/schema)