> ## Documentation Index
> Fetch the complete documentation index at: https://docs.medera.info/llms.txt
> Use this file to discover all available pages before exploring further.

# /transcripts endpoint

> REST · async batch transcription with the same BH calibration as the live endpoints.

`/api/transcripts` is the **REST batch transcription** surface — upload a recorded encounter, get a structured transcript + instrument scores back. Same engine, same DSM-5-TR vocabulary bias, same C-SSRS safety check as `/sessions` and `/transcribe`.

## Upload

```http theme={"system"}
POST /api/sessions/{id}/recordings
Content-Type: multipart/form-data
```

Limits: 60 minutes audio, 150 MB file. See [Audio Configuration](/multimodal/stt/audio).

## Trigger transcript

```http theme={"system"}
POST /api/sessions/{id}/transcripts
Content-Type: application/json

{
  "language": "en-US",
  "diarization": true,
  "speakers": 2,
  "instruments": ["phq-9", "gad-7", "c-ssrs"],
  "vocabulary": { "formulary": [...], "programs": [...] }
}
```

## Poll status

```http theme={"system"}
GET /api/sessions/{id}/transcripts/{transcript_id}/status
```

Status: `processing` → `completed` | `failed`.

## Retrieve

```http theme={"system"}
GET /api/sessions/{id}/transcripts/{transcript_id}
```

Returns the same structured shape `/sessions` returns at finalize — transcript, diarization, instrument scores, codes, SOAP draft.

<Note>
  Async batch accuracy may be slightly lower than the real-time endpoints because batch loses interactive context (no in-the-moment vocabulary biasing). Pass the practice vocabulary on every request for parity.
</Note>

***

## What's next

<CardGroup cols={2}>
  <Card title="/sessions — live capture" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/audio-lines.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=a4f3136aa8df6fe2d044778c71ba2bbc" href="/multimodal/stt/streams" width="40" height="40" data-path="icons/ui/audio-lines.svg">Stateful diarized session.</Card>
  <Card title="/transcribe — dictation" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/mic.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=2fa5bf2e6c0f7c96c6db63c83d109eb1" href="/multimodal/stt/transcribe" width="40" height="40" data-path="icons/ui/mic.svg">Between-visit dictation.</Card>
  <Card title="Audio configuration" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/settings.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=d4e5b78d0364e67249682468c3175436" href="/multimodal/stt/audio" width="40" height="40" data-path="icons/ui/settings.svg">Formats and limits.</Card>
  <Card title="Ambient async quickstart" icon="https://mintcdn.com/medera-357fd587/n1mgcc3nR2sq_PoL/icons/ui/zap.svg?fit=max&auto=format&n=n1mgcc3nR2sq_PoL&q=85&s=279c57d41af922abbba25c4afddfc3fe" href="/quickstart/ambient-async" width="40" height="40" data-path="icons/ui/zap.svg">End-to-end async walkthrough.</Card>
</CardGroup>