Retrieve calls placed through the Dialer, newest first.

When to use. Historical and audit views, and reconciliation against your CRM. For aggregated counts per lead over a period, use GET /calls/stats. For the detailed call records behind the Call Analytics report, use GET /cdrs.

Filtering and shape. Filter, order, limit and select fields by any response field. See Core API Concepts. Common filters are campaign_id, caller_user_id, start_at and end_at (ISO-8601 UTC), status, dst and dst_country. The response is wrapped as { "calls": [ ... ], "total_calls": N }.

Example. GET /api/calls/campaign_id/42/start_at/2020-09-01T00:00:00/limit/50;0

Gateway note: custom call fields defined on the account can be used as filter keys (path segments, see the _filtered variant) and are returned on each record alongside the standard fields.

{
  "calls": [
    {
      "agent_callerid_name": "demo",
      "agent_callerid_number": "12125551234",
      "agent_hangup_disposition": "recv_bye",
      "beep_detected": 0,
      "call_bill_duration": 22,
      "call_duration": 23,
      "call_uuid": "c5b52188-9e16-4ee3-b030-3ad545b1636d",
      "caller_user": "demo",
      "caller_user_id": 970,
      "client_callerid_name": "demo",
      "client_callerid_number": "12125551234",
      "cost": 0,
      "created_at": "2025-05-18 12:45:27",
      "dst": "12125551234",
      "end_at": "2025-05-18 12:45:48",
      "id": 40227,
      "object_id": 0,
      "object_type_id": 3,
      "q850": 16,
      "sip_term_status": 200,
      "src": "demo@demo.example.com",
      "start_at": "2025-05-18 12:45:27",
      "status": "NORMAL_CLEARING"
    }
  ]
}