---
title: "Returns a DAM file's subtitle tracks"
method: GET
path: "/dam/files/{file_id}/subtitles"
tags: ["DAM: Files"]
---

# Returns a DAM file's subtitle tracks

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

## Request

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

Returns the subtitle tracks of the file's current version. The cues of a track are read from its cue list, linked in relationships.cues.links.related.

## Path parameters

- `file_id` string, required

## Response `200`

success

- FileSubtitleCollection
  - `data` FileSubtitle[]
    - `id` string
    - `type` string
    - `attributes` FileSubtitleAttributes
      - `language` string
      - `label` string, nullable
      - `source` 'manual' | 'import' | 'ai'
      - `is_default` boolean
      - `version` integer
      - `created_at` string
      - `updated_at` string
    - `relationships` object
      - `cues` object
        - `links` object
          - `related` string: URL of the paged cue list of the track
    - `links` object
      - `self` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: File not found

---

[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)