---
title: "Returns the cues of a subtitle track of a DAM file"
method: GET
path: "/dam/files/{file_id}/subtitles/{subtitle_id}/cues"
tags: ["DAM: Files"]
---

# Returns the cues of a subtitle track of a DAM file

`GET /dam/files/{file_id}/subtitles/{subtitle_id}/cues`

## Request

- Base URL: `https://api.kontainer.com/jsonapi/v2`
- URL: `https://api.kontainer.com/jsonapi/v2/dam/files/{file_id}/subtitles/{subtitle_id}/cues`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kontainer/apis/kontainer-api-documentation/docs/dam/files/:file_id/subtitles/:subtitle_id/cues/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the cues of a subtitle track in playback order (start time, then id). The list is cursor-paged: follow links.next, or send its page[after] values, until it is null. Cues are written as a whole set with the track, through cues or srt on create and update.

## Path parameters

- `file_id` string, required
- `subtitle_id` string, required

## Query parameters

- `page[size]` integer
- `page[after][]` integer[]

## Response `200`

success

- FileSubtitleCueCollection
  - `data` object[]
    - `id` string
    - `type` string
    - `attributes` FileSubtitleCue
      - `start_ms` integer, required
      - `end_ms` integer, required
      - `text` string, required
  - `meta` object
    - `page` object
      - `size` integer
      - `after` integer[], nullable: The cursor this page was read after; null on the first page.
  - `links` object: Pagination links. "next" is null on the last page.
    - `self` string
    - `first` string
    - `next` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: File or subtitle not found
- `422`: Invalid page[size] or page[after]

---

[API](https://skmtc.dev/kontainer/apis/kontainer-api-documentation.md) - [All operations](https://skmtc.dev/kontainer/apis/kontainer-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kontainer/apis/kontainer-api-documentation/revisions/b80a5167e09a?raw)