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

# Transcriptions

`POST /api/v1/transcriptions`

Transcribe one complete audio file. Returns the text only (no note).

## Request — multipart/form-data

| Field      | Required | Notes                                            |
| ---------- | -------- | ------------------------------------------------ |
| `file`     | yes      | Audio file (`wav`, `mp3`, `m4a`, `ogg`, `webm`). |
| `language` | no       | BCP-47 code. Auto-detected if omitted.           |

```bash theme={null}
curl -X POST https://api.recnote.ai/api/v1/transcriptions \
  -H "Authorization: Bearer $RECNOTE_API_KEY" \
  -F "file=@consultation.wav" \
  -F "language=sv"
```

## Response

```json theme={null}
{ "transcript": "Patienten söker för..." }
```

## Errors

| Status | Reason                         |
| ------ | ------------------------------ |
| 400    | No file provided.              |
| 401    | Invalid API key.               |
| 502    | Upstream transcription failed. |