Recordings
Retrieve a Recording
Fetch full metadata for a specific Vobiz call recording by ID - file URL, duration, format, associated call UUID, and storage billing.
GET
/
api
/
v1
/
Account
/
{auth_id}
/
Recording
/
{recording_id}
/
Retrieve a recording
curl --request GET \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/{recording_id}/ \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/{recording_id}/"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/{recording_id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"add_time": "2026-03-25 10:00:00.000000+05:30",
"api_id": "55667788-1234-5678-90ab-cdef12345678",
"call_uuid": "55667788-1234-5678-90ab-cdef12345678",
"conference_name": null,
"from_number": "+919876543210",
"monthly_recording_storage_amount": 0,
"recording_duration_ms": "7880.00000",
"recording_end_ms": null,
"recording_format": "wav",
"recording_id": "55667788-1234-5678-90ab-cdef12345678",
"recording_start_ms": null,
"recording_storage_duration": 6,
"recording_storage_rate": 0.005,
"recording_type": "trunk",
"recording_url": "https://recordings.vobiz.ai/example/abc123.mp3",
"resource_uri": "/v1/Account/MA_XXXXXXXX/Recording/55667788-1234-5678-90ab-cdef12345678/",
"rounded_recording_duration": 60,
"to_number": "+918012345678"
}GET https://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/{recording_id}/
Authentication required:
X-Auth-ID- Your account auth_id (e.g.,{auth_id})X-Auth-Token- Your account Auth TokenContent-Type: application/json
You can obtain the
recording_id from the List All Recordings endpoint or from webhook notifications when recordings are created.Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
auth_id | string | Yes | Your account ID. |
recording_id | string | Yes | The unique recording identifier. |
Response
Returns a complete Recording object with all attributes if the recording ID is valid. The single-recording response is a flat object (the fields are at the top level), unlike the List All Recordings response, which wraps each recording insidemeta + objects[].
Response - 200 OK
{
"add_time": "2025-11-06 13:49:10.751756+00:00",
"api_id": "668470b7-7a8f-49b6-9011-50075754a50a",
"call_uuid": "6e558798-499c-4a68-bc77-46f2c53d1f69",
"conference_name": null,
"from_number": "+918071387423",
"monthly_recording_storage_amount": 0,
"recording_duration_ms": "10080.00000",
"recording_end_ms": "1762436949502.00000",
"recording_format": "mp3",
"recording_id": "d7801b2e-e76d-4dd8-be9c-9e015a7267b8",
"recording_start_ms": "1762436939422.00000",
"recording_storage_duration": 1,
"recording_storage_rate": 0.005,
"recording_type": "call",
"recording_url": "https://media.vobiz.ai/api/v1/Account/MA_XXXXXXXX/Recording/d7801b2e-e76d-4dd8-be9c-9e015a7267b8.mp3",
"resource_uri": "/v1/Account/MA_XXXXXXXX/Recording/d7801b2e-e76d-4dd8-be9c-9e015a7267b8/",
"rounded_recording_duration": 60,
"to_number": "919624705678"
}
Response - 404 Not Found
{
"api_id": "correlation-id-uuid",
"error": "Recording not found"
}
Because the body is flat, extract fields directly - e.g.
jq -r '.recording_url'. There is no objects[0] wrapper on this endpoint.Examples
cURL Request
cURL
curl -X GET https://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/abc123def456/ \
-H "X-Auth-ID: YOUR_AUTH_ID" \
-H "X-Auth-Token: YOUR_AUTH_TOKEN"
Download Recording File
Use therecording_url from the response to download the actual audio file. For a complete step-by-step guide including authentication details and troubleshooting, see the Download Recording Guide.
Using jq to Extract URL
Bash Script with jq
# Get recording URL and download in one command
RECORDING_URL=$(curl -s -X GET https://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/abc123def456/ \
-H "X-Auth-ID: YOUR_AUTH_ID" \
-H "X-Auth-Token: YOUR_AUTH_TOKEN" \
| jq -r '.recording_url')
curl -o recording.mp3 "$RECORDING_URL"
Use Cases:
- Verify recording details before downloading
- Check storage duration for billing purposes
- Confirm recording format (MP3 vs WAV)
- Get the download URL for archiving
- Validate recording metadata (call_uuid, phone numbers)
The
recording_url provides direct access to the audio file and can be used in media players or downloaded programmatically. These URLs may be temporary, so download recordings promptly for permanent storage.Important: Always check the
api_id field in responses for correlation and debugging purposes. This ID is useful when contacting support about specific requests.Authorizations
Path Parameters
Response
200 - application/json
Recording details
Was this page helpful?
⌘I
Retrieve a recording
curl --request GET \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/{recording_id}/ \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/{recording_id}/"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/{recording_id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"add_time": "2026-03-25 10:00:00.000000+05:30",
"api_id": "55667788-1234-5678-90ab-cdef12345678",
"call_uuid": "55667788-1234-5678-90ab-cdef12345678",
"conference_name": null,
"from_number": "+919876543210",
"monthly_recording_storage_amount": 0,
"recording_duration_ms": "7880.00000",
"recording_end_ms": null,
"recording_format": "wav",
"recording_id": "55667788-1234-5678-90ab-cdef12345678",
"recording_start_ms": null,
"recording_storage_duration": 6,
"recording_storage_rate": 0.005,
"recording_type": "trunk",
"recording_url": "https://recordings.vobiz.ai/example/abc123.mp3",
"resource_uri": "/v1/Account/MA_XXXXXXXX/Recording/55667788-1234-5678-90ab-cdef12345678/",
"rounded_recording_duration": 60,
"to_number": "+918012345678"
}