# Download the subtitles of the approval

`GET https://api.cream-ai.de/api/v1/films/{id}/subtitles.srt`

Downloads the subtitles (SubRip) that were frozen with the active approval of a film ordered through the API. Only the subtitles of the approval are returned, never a newer state: `404 subtitles_not_available` if the approval has none (`subtitles_url` of the film is then `null`). ETag, `If-None-Match`, `Range` and `HEAD` work as for the film file.

Scopes: `files:read`

## Parameters

- `id` (path, required): Id of the film (id from POST /films, GET /films or film_id of an event).
- `Range` (header): One byte range.
- `If-Range` (header): The ETag of the first response.
- `If-None-Match` (header): The ETag you already have; 304 if unchanged.

## Returns

- 200: The subtitles (UTF-8).
- 206: The requested part of the subtitles.
- 304: Unchanged.

## Errors

- 401: Missing, malformed, revoked or expired API key (unauthorized).
- 403: Not allowed (forbidden_scope, ip_not_allowed, company_inactive, api_not_enabled).
- 404: Not found (not_found), not approved (not_approved) or the approval has no subtitles (subtitles_not_available).
- 409: The subtitles are not available (file_unavailable). mint is informed; retry later.
- 416: The range is behind the end of the file (range_not_satisfiable).
- 429: Too many requests (rate_limited).
- 500: Internal error (internal). Quote the request id when you contact support.
- 503: Temporarily unavailable (service_unavailable). Retry later (after Retry-After seconds, if sent).

## Example request

```sh
curl "https://api.cream-ai.de/api/v1/films/k7m2xq9v4t8n1b5r3c6d0wza/subtitles.srt" \
  -H "Authorization: Bearer $MINT_API_KEY" \
  -o film.srt
```

## Example response (200)

```http
HTTP/1.1 200 OK
Content-Type: application/x-subrip
X-Request-Id: req_5b2e8f1a4c7d0e3b6a9f2c5d8e1b4a7c
ETag: "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c2b4d6f8e0a1c3e5b7d9f1a3c5e7b9d2f"
Accept-Ranges: bytes
Content-Length: 6214
Content-Disposition: attachment; filename="k7m2xq9v4t8n1b5r3c6d0wza_r2.srt"
Cache-Control: no-store, no-transform

1
00:00:00,000 --> 00:00:04,200
Not every customer wants the same thing.
```