---
title: "Get recording transcript"
method: GET
path: "/recordings/{token}/transcript"
tags: ["Recordings"]
---

# Get recording transcript

`GET /recordings/{token}/transcript`

Returns the full transcript grouped into paragraphs and sentences.

Use the optional `lang` query parameter to request a translated transcript.

Rate limits:
- Global: 120 requests per minute per API key.

## Path parameters

- `token` string, required

## Query parameters

- `lang` string
- `format` 'json' | 'plaintext'

## Response `200`

Transcript fetched successfully.

- RecordingTranscriptResponse
  - `data` Transcript, required
    - `language` string, required
    - `paragraphs` TranscriptParagraph[], required
      - `startInSeconds` number, required
      - `endInSeconds` number, required
      - `speaker` TranscriptSpeaker, required
        - `displayName` string, nullable, required
      - `sentences` TranscriptSentence[], required
        - `startInSeconds` number, required
        - `endInSeconds` number, required
        - `text` string, required

## Other responses

- `202` — Transcript is still being processed.
- `204` — Transcript exists but is empty or too short.
- `400` — Request validation failed.
- `401` — API key is missing or invalid.
- `404` — Recording or related resource was not found.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/demodesk/apis/demodesk-public-api.md) · [All operations](https://skmtc.net/demodesk/apis/demodesk-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/demodesk/demodesk-public-api/revisions/3c40ff85e81d/schema)