Skip to main content
GET
/
api
/
calls
/
{callId}
curl -X GET "https://api.zudu.ai/api/calls/call_abc123def456" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..."

{
  "message": "Call retrieved successfully",
  "status": "success",
  "error": null,
  "data": {
    "call_id": "call_abc123def456",
    "agent_id": "agent_1234567890",
    "organization_id": "org_1234567890",
    "call_status": "ENDED",
    "call_type": "PHONE_CALL",
    "from_number": "+14157774444",
    "to_number": "+12137774445",
    "direction": "OUTBOUND",
    "created_at": 1705320000000,
    "updated_at": 1705320100000,
    "start_timestamp": 1705320010000,
    "end_timestamp": 1705320100000,
    "metadata": {
      "customer_id": "cust-001",
      "campaign": "summer-2024"
    },
    "events": []
  }
}
Retrieve detailed information about a specific call by its call ID. 
curl -X GET "https://api.zudu.ai/api/calls/call_abc123def456" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..."

{
  "message": "Call retrieved successfully",
  "status": "success",
  "error": null,
  "data": {
    "call_id": "call_abc123def456",
    "agent_id": "agent_1234567890",
    "organization_id": "org_1234567890",
    "call_status": "ENDED",
    "call_type": "PHONE_CALL",
    "from_number": "+14157774444",
    "to_number": "+12137774445",
    "direction": "OUTBOUND",
    "created_at": 1705320000000,
    "updated_at": 1705320100000,
    "start_timestamp": 1705320010000,
    "end_timestamp": 1705320100000,
    "metadata": {
      "customer_id": "cust-001",
      "campaign": "summer-2024"
    },
    "events": []
  }
}

​
Headers

​
X-API-KEY
string
required
Your API key (format: sk_...)
​
X-API-SECRET
string
required
Your API secret (format: s3cr3t_...)

​
Path Parameters

​
callId
string
required
The unique identifier of the callFormat: call_...Example: call_abc123def456

​
Response Fields

​
data.call_id
string
The unique identifier for the call
​
data.agent_id
string
The ID of the agent assigned to this call
​
data.organization_id
string
The organization ID this call belongs to
​
data.call_status
string
Current status of the callValues: REGISTERED, ONGOING, ENDED, ERROR, SCHEDULED
​
data.call_type
string
Type of callValues: PHONE_CALL, WEB_CALL
​
data.from_number
string
Source phone number (for phone calls)Format: E.164 (e.g., +14157774444)
​
data.to_number
string
Destination phone number (for phone calls)Format: E.164 (e.g., +12137774445)
​
data.direction
string
Call directionValues: INBOUND, OUTBOUND
​
data.start_timestamp
integer
Unix timestamp (milliseconds) when the call started
​
data.end_timestamp
integer
Unix timestamp (milliseconds) when the call ended
​
data.metadata
object
Custom metadata attached to the call
​
data.events
array
Array of call events in chronological order

​
Error Responses

​
error
string
Not Found - Call does not exist
{
  "message": "Call not found",
  "status": "error",
  "error": "Call with ID 'call_abc123' does not exist"
}
​
error
string
Unauthorized - Missing or invalid API key/secret
​
error
string
Internal Server Error - Failed to retrieve call

​
Notes

  • The organization ID is automatically extracted from your API key
  • Only calls belonging to your organization can be retrieved
  • The response includes complete call details including metadata and events timeline