---
title: "Download Subtitles"
method: GET
path: "/v1/transcript/{media_id}/{locale}/download/subtitles"
tags: ["transcript"]
---

# Download Subtitles

`GET /v1/transcript/{media_id}/{locale}/download/subtitles`

## Request

- Base URL: `https://api.lingopal.ai`
- URL: `https://api.lingopal.ai/v1/transcript/{media_id}/{locale}/download/subtitles`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/lingopal/apis/lingopal-api-v1/docs/v1/transcript/:media_id/:locale/download/subtitles/get.ts> (a function with typed inputs; its response is checked against the schema)

Download subtitles in SRT or VTT format for a specific media and locale.

Args:
    media_id: The ID of the media
    locale: The language locale (e.g., 'en', 'es', 'fr')
    file_type: The subtitle format - either 'srt' or 'vtt'
    file_name: Optional custom filename (without extension)

Returns:
    Response with subtitle file content

## Path parameters

- `locale` string, required
- `media_id` string, required

## Query parameters

- `file_type` 'srt' | 'vtt'
- `file_name` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `422`: Validation Error

---

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