Call Recording
You do not need to build the full URL of this endpoint yourself. The ready-to-use URL is returned in two places:
- In the
recordUrlfield of the Call Analysis Completed webhook payload - In the
recordUrlfield of each record in the Call Records response
Path Parameters
Authentication
This endpoint requires the same Bearer token as the other Public API endpoints. See the Authentication page to get a token.
Opening the recordUrl link in a browser returns 401, because the browser does not add the token to the request. You must request the recording with the Authorization header.
Example cURL
curl --request GET 'https://public-api.thinkvoice.ai/api/app/public-calls/019e925a-5f79-7778-b0be-a45a146cf828/record' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--output recording.wavResponses
Recordings in WAV format are converted to playable PCM WAV and returned as audio/wav. Recordings that arrive from the provider in a format other than WAV are returned unconverted, with the provider’s Content-Type.
Error Cases
| Case | HTTP | Description |
|---|---|---|
Invalid id | 400 | id is not in a valid UUID format. |
| Missing or invalid token | 401 | This error is also returned when the link is opened in a browser. |
| Recording could not be retrieved | 403 | The recording could not be retrieved from the provider. The message field starts with Kayıt dosyası alınamadı: (“Recording file could not be retrieved:”) followed by the reason. |
| Audio file could not be processed | 403 | The recording was retrieved but could not be processed. The message field starts with Ses dosyası işlenemedi: (“Audio file could not be processed:”) followed by the reason. |
| Call not found | 404 | No call matches the id, or the call belongs to another tenant. No recording is returned for another tenant’s call. |
| Rate limit exceeded | 429 | The Retry-After header indicates how long to wait, in seconds. |
The message text in 403 responses may vary depending on the provider the recording is retrieved from.
Recording download requests also count toward the rate limit.