Get a call | Dial — Communication Stack for AI Agents

{
  "call": {
    "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 a single call, including its status, duration, and, once available, its transcript both as flat text (transcript) and as timed turns (transcriptTurns).

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

Response

The call.

callobjectOptional

Errors

401

Unauthorized Error

404

Not Found Error