---
title: "List team time offs"
method: GET
path: "/teams/{team_id}/time_offs"
tags: ["Time Off"]
---

# List team time offs

`GET /teams/{team_id}/time_offs`

List the time offs of all teammates in a team.

Required scope: `time_off:read`

## Path parameters

- `team_id` string, required

## Query parameters

- `limit` integer
- `page_token` string
- `q` string

## Response `200`

Array of time offs

- object
  - `_pagination` object
    - `next` string, nullable — Link to next [page of results](https://dev.frontapp.com/docs/pagination)
  - `_links` object
    - `self` string — Link to resource
  - `_results` 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)