Calls

Get a call

GET/v1/calls/{call_id}

Needs the calls:read scope.

Path parameters

call_idstringrequired

Call id

Returns

The call. A failed call answers with an error instead.

idstring

createdAtstring

directionCallDirection

inbound | outbound.

durationintegernullable

Talk time in seconds; null while the call is still up.

endedAtstringnullable

fromstringnullable

hasRecordingboolean

Whether the call left a recording, summary or transcript to fetch.

hasSummaryboolean

hasTranscriptboolean

isVoicemailboolean

missedboolean

numberIdstringnullable

Null for a teammate-to-teammate call, which never touches a number.

startedAtstringnullable

statusstring

tostringnullable

curl https://api.ringhouse.ai/v1/calls/{call_id} \
  -H "Authorization: Bearer rh_live_xxxxxxxx"

{
  "id": "8c1d4e7a-5b2f-4a90-9e1c-3f7d2b6a1c08",
  "createdAt": "2026-09-25T14:02:11Z",
  "direction": "inbound",
  "duration": 184,
  "endedAt": "2026-09-25T14:05:15Z",
  "from": "+447700900123",
  "hasRecording": false,
  "hasSummary": false,
  "hasTranscript": false,
  "isVoicemail": false,
  "missed": false,
  "numberId": "e41b09c2-77d3-4c5e-b0a8-9d2f61c4e3a7",
  "startedAt": "2026-09-25T14:02:11Z",
  "status": "completed",
  "to": "+441134960000"
}

Was this page helpful?

Previous← List calls NextGet a recording