Recordings API reference
Last updated: 2026-06-01
Download, search, and delete call recordings. Recording metadata lives on the CDR record — use the CDR endpoints to find a recording, then call here to fetch the audio.
Required scope
recording:read, recording:write
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /recording/list | Search recordings by date, extension, queue. |
GET | /recording/download?id=rec_1 | Stream the audio file (mp3/wav). |
GET | /recording/metadata?id=rec_1 | Duration, file size, format, retention. |
POST | /recording/delete | Permanently delete a recording. |
Common errors
40001— Missing or invalid parameter.40301— API key lacks the scope this endpoint requires.40401— Resource not found.50001— Internal error; safe to retry with backoff.