---
title: "Get time off"
method: GET
path: "/time_offs/{time_off_id}"
tags: ["Time Off"]
---

# Get time off

`GET /time_offs/{time_off_id}`

Fetch a time off.

Required scope: `time_off:read`

## Path parameters

- `time_off_id` string, required

## Response `200`

A time off

- TimeOffResponse
  - `_links` object, required
    - `self` string — Link to the time off resource
    - `related` object
      - `teammate` string — Link to the teammate this time off belongs to
  - `id` string, required — Unique identifier of the time off
  - `name` string, required — Name of the time off
  - `start_at` number, required — Timestamp when the time off starts
  - `end_at` number, nullable — Timestamp when the time off ends, or null if open-ended
  - `created_at` number — Timestamp when the time off was created
  - `updated_at` number — Timestamp when the time off was last updated
  - `auto_responder` object, required
    - `is_enabled` boolean — Whether the auto-responder is enabled
    - `channel_ids` string[] — List of channel IDs the auto-responder applies to
    - `is_contacts_only` boolean — Whether the auto-responder only replies to known contacts
    - `body` string — The auto-reply message body

---

[API](https://skmtc.dev/frontapp/apis/core-api.md) · [All operations](https://skmtc.dev/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)