Skip to Content
WebhookCall Recording

Call Recording

GET/api/app/public-calls/{id}/record
Returns the call recording as a file. Only recordings of calls that belong to the token owner's tenant can be downloaded.

You do not need to build the full URL of this endpoint yourself. The ready-to-use URL is returned in two places:

Path Parameters

FieldTypeRequiredDescription
idstring (UUID)YesID of the call. This is the callId value from the webhook payload or the Call Records response.

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.wav

Responses

200Success. The body is the audio file itself.
Content-Type: audio/wav <binary>

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.

400id is not a valid UUID
{ "error": { "code": null, "message": "Doğrulama hatası.", "details": "<error message>", "validationErrors": [ { "message": "<error message>", "members": ["id"] } ] } }
401Token is invalid or missing
{ "error": "invalid_token" }
403Recording could not be retrieved or processed
{ "error": { "code": null, "message": "Kayıt dosyası alınamadı: <reason>", "details": null, "validationErrors": null } }
404Call not found
{ "error": { "code": null, "message": "<error message>", "details": null, "validationErrors": null } }
429Rate limit exceeded. The limit is 40 requests per 60 seconds.
Retry-After: 60

Error Cases

CaseHTTPDescription
Invalid id400id is not in a valid UUID format.
Missing or invalid token401This error is also returned when the link is opened in a browser.
Recording could not be retrieved403The 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 processed403The 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 found404No call matches the id, or the call belongs to another tenant. No recording is returned for another tenant’s call.
Rate limit exceeded429The 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.

Last updated: