---
title: "Get Roster"
method: GET
path: "/tsa/v2/rosters/{rosterId}"
tags: ["Roster"]
---

# Get Roster

`GET /tsa/v2/rosters/{rosterId}`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/tsa/v2/rosters/{rosterId}`
- Auth: API key in header `OAuth`

Fetch a roster by ID with detailed information including child rosters and area details.

## Path parameters

- `rosterId` integer, required

## Response `200`

A successful response.

- TsaGetRosterResponse
  - `success` boolean
  - `roster` ModelRoster
    - `id` integer
    - `date` string
    - `startTime` string, int64
    - `endTime` string, int64
    - `mealbreakDuration` string
    - `mealbreakSlots` string
    - `note` string
    - `children` RosterChildRoster[]
      - `id` integer
      - `date` string
      - `startTime` string, int64
      - `endTime` string, int64
      - `area` Tenanttsav2modelArea
        - `id` integer
        - `name` string
        - `color` string
        - `location` V2modelLocation
          - `id` integer
          - `name` string
        - `timezone` string: IANA timezone identifier (e.g., "America/New_York"). Do not use offset strings.
    - `area` Tenanttsav2modelArea
      - `id` integer
      - `name` string
      - `color` string
      - `location` V2modelLocation
        - `id` integer
        - `name` string
      - `timezone` string: IANA timezone identifier (e.g., "America/New_York"). Do not use offset strings.

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)