---
title: "Get transcripts in batch"
method: POST
path: "/transcripts/batch"
tags: ["Recordings"]
---

# Get transcripts in batch

`POST /transcripts/batch`

Returns transcripts for `n` recordings (`n` <= 100).
Results are returned with a per-recording status.

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

## Request body

- TranscriptBatchRequest
  - `recordingTokens` string[], required
  - `lang` string — Translate results to the provided language on-the-fly. Examples: `de`, `fr`, etc.
  - `format` 'json' | 'plaintext' — Whether you want structured data for every single sentence or the transcript merged into plain text.

## Response `200`

Transcript batch fetched successfully.

- TranscriptBatchResponse
  - `data` TranscriptBatchItem[], required
    - `recordingToken` string, required
    - `status` 'ready' | 'processing' | 'not_requested' | 'empty' | 'not_found', required
    - `transcript` union, required
      - Transcript
        - `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
      - TranscriptPlaintext
        - `language` string, required
        - `text` string, required
  - `meta` object, required
    - `requestedCount` integer, required

## Other responses

- `400` — Request validation failed.
- `401` — API key is missing or invalid.
- `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)