List calls | Dial — Communication Stack for AI Agents

{
  "calls": [
    {
      "id": "string",
      "phoneNumberId": "string",
      "from": "+14155550123",
      "to": "+14155559876",
      "direction": "inbound",
      "status": {
        "state": "Ringing",
        "terminationType": null,
        "cancelRequested": false,
        "cancelPending": false,
        "label": "Ringing"
      },
      "duration": 0,
      "transcript": "string",
      "transcriptTurns": [
        {
          "speaker": "agent",
          "text": "Hi, how can I help?",
          "startMs": 1200,
          "endMs": 2650
        }
      ],
      "voiceRuntime": "managed",
      "failureReason": "self_hosted_key_rejected",
      "instruction": "string",
      "transferTo": "+14155550100",
      "transferredAt": "2024-01-15T09:30:00Z",
      "createdAt": "2024-01-15T09:30:00Z"
    }
  ]
}

Returns up to 100 of the most recent calls on the account's numbers.

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Query parameters

contactstringOptional

One conversation: calls exchanged with this number, in both directions, across every line on the account.

numberIdstringOptional

Filter to a single phone number. A replaced number's ID filters to the number that replaced it, whose history includes the replaced number's.

directionenumOptional

Allowed values:

sincedatetimeOptional

Only calls created after this timestamp.

Response

Calls, newest first.

callslist of objectsOptional

Errors

401

Unauthorized Error