---
title: "The captions on a clip"
method: GET
path: "/clips/{id}/captions"
tags: ["Clips"]
---

# The captions on a clip

`GET /clips/{id}/captions`

## Request

- Base URL: `https://tryslicemedia.com/api/v1`
- URL: `https://tryslicemedia.com/api/v1/clips/{id}/captions`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Query parameters

- `at` number
- `from` number
- `to` number
- `q` string
- `limit` integer

## Response `200`

OK

- object
  - `clip_id` string
  - `name` string
  - `total` integer
  - `captions` object[]
    - `id` string
    - `start_seconds` number
    - `end_seconds` number
    - `speaker` string
    - `text` string

## Other responses

- `401`: Missing, unknown, revoked or expired key.
- `403`: The key lacks the permission (scope) this needs, or the account is under billing review.
- `404`: Not on this account.
- `429`: Rate limited. See retry_after and the RateLimit-* headers.

---

[API](https://skmtc.dev/tryslicemedia/apis/slice-api.md) · [All operations](https://skmtc.dev/tryslicemedia/apis/slice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tryslicemedia/apis/slice-api/revisions/3dc0b0bd8755?raw)