Skip to main content
GET
/
api
/
calls
List calls (GET)
curl --request GET \
  --url http://localhost:8080/api/calls \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-API-SECRET: <api-key>'
{
  "message": "Calls retrieved successfully",
  "status": "success",
  "error": null,
  "data": {
    "organization_id": "org-789",
    "calls": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "call_id": "call-456",
        "agent_id": "agent-123",
        "organization_id": "org-789",
        "call_status": "ENDED",
        "call_type": "PHONE_CALL",
        "direction": "OUTBOUND",
        "from_number": "+0987654321",
        "to_number": "+1234567890",
        "start_timestamp": 1703097600000,
        "end_timestamp": 1703098200000,
        "call_duration": 600000,
        "disconnection_reason": "USER_HANGUP",
        "recording_url": "https://storage.azure.com/recordings/call-456.mp4",
        "public_log_url": "https://api.example.com/logs/call-456",
        "opt_out_sensitive_data_storage": false,
        "metadata": {
          "customer_id": "cust-001",
          "priority": "high",
          "campaign": "summer-2024",
          "batch_call_id": "batch-001"
        },
        "events": [],
        "transcript": "Hello, I'm calling about my recent order. Thank you for your help!",
        "transcript_object": [],
        "transcript_with_tool_calls": [],
        "latency": {
          "e2e": {
            "max": 350.1,
            "min": 120.5,
            "num": 12,
            "p50": 150.5,
            "p90": 280.2,
            "p95": 320.8,
            "p99": 345.3,
            "values": [
              120.5,
              135.2,
              150.5,
              280.2,
              350.1
            ]
          }
        },
        "call_analysis": {
          "call_successful": true,
          "call_summary": "Customer inquiry about order status - resolved successfully",
          "user_sentiment": "Positive",
          "in_voicemail": false
        },
        "call_cost": {
          "combined_cost": 0.25
        },
        "telephony_identifier": {
          "call_sid": "CA1234567890abcdef1234567890abcdef",
          "conference_sid": "CF1234567890abcdef1234567890abcdef"
        }
      }
    ],
    "pagination": {
      "page": 0,
      "limit": 20,
      "total_count": 25,
      "total_pages": 2,
      "has_next_page": true,
      "has_previous_page": false
    },
    "returned_count": 1,
    "sort_order": "descending",
    "sort_by": "start_timestamp",
    "applied_filters": {}
  }
}

Authorizations

X-API-KEY
string
header
required

API Key for MCP server and external service authentication

X-API-SECRET
string
header
required

API Secret for MCP server and external service authentication

Response

200 - application/json

Calls retrieved successfully

message
string
status
string
error
string
data
object