---
title: "Get a specific text track"
method: GET
path: "/videos/{video_id}/texttracks/{texttrack_id}"
tags: ["Videos\\Text tracks"]
---

# Get a specific text track

`GET /videos/{video_id}/texttracks/{texttrack_id}`

## Request

- Base URL: `https://api.vimeo.com`
- URL: `https://api.vimeo.com/videos/{video_id}/texttracks/{texttrack_id}`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`, token URL `/oauth/access_token`
  - Client credentials, token URL `/oauth/authorize/client`
  - Scopes: `create`, `delete`, `edit`, `email`, `interact`, `private`, `promo_codes`, `public`, `purchase`, `purchased`, `stats`, `upload`, `video_files`
- TypeScript: <https://skmtc.dev/vimeo/apis/vimeo-api/docs/videos/:video_id/texttracks/:texttrack_id/get.ts> (a function with typed inputs; its response is checked against the schema)

This method returns a single text track from the specified video.

## Path parameters

- `texttrack_id` number, required
- `video_id` number, required

## Response `200`

The text track was returned.

- TextTrack
  - `active` boolean, required: Whether this text track is active.
  - `hls_link` string, required: The read-only URL of the text track file, intended for use with HLS playback.
  - `hls_link_expires_time` string, required: The time in ISO 8601 format when the read-only HLS playback text track file expires.
  - `language` string, nullable, required: The language code for this text track. To see a full list, request `/languages?filter=texttrack`.
  - `link` string, required: The read-only URL of the text track file. You can upload to this link when you create it for the first time.
  - `link_expires_time` string, required: The time in ISO 8601 format when the text track link expires.
  - `name` string, nullable, required: The descriptive name of this text track.
  - `type` 'captions' | 'subtitles', nullable, required: The type of the text track: Option descriptions: * `captions` - The text track is for captions. * `subtitles` - The text track is for subtitles.
  - `uri` string, required: The relative URI of the text track.

## Other responses

- `403`: * Error code 3430: The authenticated user doesn't have permission to access the text track. * Error code 3431: This text track is disabled.
- `404`: * No such video or text track exists. * Error code 5014: The specified text track doesn't exist. * Error code 5015: The specified text track belongs to a different video.

## Changes

- **2019-04-12** `80428f626f3e`: 2 info
  - api tag `Videos\Text tracks` added
  - api tag `Videos\Text Tracks` removed
- **2018-12-05** `26f856a94041`: 2 info
  - api tag `Videos\Text Tracks` added
  - api tag `Videos\Text tracks` removed

[Operation history](https://skmtc.dev/vimeo/apis/vimeo-api/changes/videos/:video_id/texttracks/:texttrack_id/get.md)

---

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