Retrieve a Recording

Get detailed information about a specific recording using its recording ID.

This API allows you to retrieve the details of a specific recording based on its recording ID. The response includes complete information about the recording file, associated call details, storage duration, and billing information.

Note: You can obtain the recording_id from the List all recordings endpoint or from webhook notifications when recordings are created.

HTTP Request

GEThttps://api.vobiz.ai/api/v1/Account/{auth_id}/Recording/{recording_id}/

Authentication Headers

X-Auth-ID:Your account auth_id (e.g., {Auth_ID})

X-Auth-Token:Your account auth token

Path Parameters:

• {auth_id} - Your account ID
• {recording_id} - The unique recording identifier

Response

Returns a complete Recording object with all attributes if the recording ID is valid.

Success Response (200 OK)

Response - 200 OK

{
    "api_id": "668470b7-7a8f-49b6-9011-50075754a50a",
    "meta": {
        "limit": 20,
        "next": null,
        "offset": 0,
        "previous": null,
        "total_count": 1
    },
    "objects": [
        {
            "add_time": "2025-11-06 13:49:10.751756+00:00",
            "call_uuid": "6e558798-499c-4a68-bc77-46f2c53d1f69",
            "conference_name": "",
            "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_PU0XU668/Recording/d7801b2e-e76d-4dd8-be9c-9e015a7267b8.mp3",
            "resource_uri": "/v1/Account/MA_PU0XU668/Recording/d7801b2e-e76d-4dd8-be9c-9e015a7267b8/",
            "rounded_recording_duration": 60,
            "to_number": "919624705678"
        }
    ]
}

Error Response (404 Not Found)

Response - 404 Not Found

{
    "api_id": "correlation-id-uuid",
    "error": "Recording not found"
}

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 the recording_url from the response to download the actual audio file:

Two-Step Process

# Step 1: Get the recording details
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"

# Step 2: Extract recording_url from response and download
# Example URL: https://media.vobiz.ai/api/v1/Account/MA_PU0XU668/Recording/d7801b2e-e76d-4dd8-be9c-9e015a7267b8.mp3
curl -o recording.mp3 "https://media.vobiz.ai/api/v1/Account/MA_PU0XU668/Recording/d7801b2e-e76d-4dd8-be9c-9e015a7267b8.mp3"

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)

Tip: The recording_url provides direct access to the audio file and can be used in media players or downloaded programmatically. However, these URLs may be temporary, so download recordings immediately 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.

The Recording Object

List all Recordings