h1. HTTP API recordings

{{>toc}}

Returns the URL of the audio recording of a call.

h2. Required arguments

| *argument* | *description* |
| uniqueid | unique call ID, matches uniqueid from [[HTTP API cdr|cdr]] and [[HTTP API active_calls|active_calls]] |

h2. Optional arguments

|*argument*|*description*|
| noredirect | 1 - the audio recording URL is returned in the body of the HTTP response with a status of 200 OK,
not specified - the audio URL is returned in the HTTP response in the Location header, with a status of 302 Found and with MIME type audio / mpeg |

h2. Returned data

h3. Audio Record Found

| field | noredirect not specified | noredirect = 1 |
| HTTP response status | 302 Found | 200 OK |
| MIME type | audio / mpeg ||
| Location header | audio URL ||
| HTTP response body || audio recording URL |

h3. Audio recording not found or error

| HTTP status | 200 OK |
| HTTP response | text description of the error |

h2. Examples

| *query* | GET "https://your.server.name/api/recordings/12122545.334 |
| HTTP response status | 302 Found |
| MIME type | audio / mpeg |
| Location header | https://name.your.server/spool/api/12122545.334.mp3 |
| HTTP response body ||

| *query* | GET "https://your.server.name/api/recordings/12122545.334?noredirect=1 |
| HTTP response status | 200 OK |
| MIME type ||
| Location header ||
| HTTP response body | https://your.server.name/spool/api/12122545.334.mp3 |

[[HTTP интерфейс recordings|Русский перевод]]