Retrieve a Call (CDR)

Retrieve the call detail record (CDR) of a specific call using its unique call UUID.

This endpoint allows you to retrieve detailed information about a completed or in-progress call. The response includes all call metadata, duration, pricing, call direction, and status information.

Authentication Required:

• X-Auth-ID: Your account ID (e.g., {Auth_ID})
• X-Auth-Token: Your account Auth Token
• Content-Type: application/json

Note: The call detail record (CDR) is typically available immediately after a call is initiated. For completed calls, it includes final billing information, duration, and end cause.

HTTP Request

GETGET https://api.vobiz.ai/api/v1/Account/{accountId}/Call/{callUuid}/

Path Parameters

auth_idstringRequired

Your Vobiz account ID (e.g., {Auth_ID})

call_uuidstringRequired

Unique identifier of the call to retrieve

No Request Body Required: This endpoint does not require any request body parameters. Simply provide the account ID and call UUID in the URL path.

Response

Returns the complete Call object with all CDR details including duration, pricing, call flow, and termination information.

Response - 200 OK

{
  "api_id": "uuid-here",
  "call_uuid": "call-uuid-here",
  "request_uuid": "request-uuid-here",
  "from": "14155551234",
  "to": "14155555678",
  "status": "in-progress",
  "direction": "outbound",
  "duration": 120,
  "billed_duration": 120,
  "call_rate": "0.02",
  "total_cost": "0.04",
  "created_at": "2025-01-15T10:30:00Z",
  "answered_at": "2025-01-15T10:30:05Z"
}

Response Fields

api_id - Unique identifier for this API request

call - The Call object containing all CDR details (see Call Object for field descriptions)

Example Request

cURL Example

curl -X GET https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/ \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"

Error Response (404 Not Found)

Response - 404 Not Found

{
  "error": "call not found",
  "call_uuid": "invalid-uuid"
}

Use Cases

•Retrieve billing information for a specific call
•Check call duration and termination reason
•Verify STIR/SHAKEN attestation for compliance
•Audit call records for quality assurance
•Reconcile call costs with account balance changes

Tip: For batch CDR retrieval or filtering by date range, use the Retrieve All Calls endpoint instead.

Machine Detection

Transfer a Call