Retrieve a call

GET/v1/calls/{id}

Fetch a call, its status as it moves, and, once it completes, its structured answer.

Prefer call.completed over polling: it carries the same answer and your metadata. A finished call is also in Payer calls in the Daybook app with its transcript and captured fields, and the MCP tools list_calls and get_call read it; a completed call with a reference number also moves its claim to what the payer said. See Payer calls.

Call this with AIA brief with this endpoint's request, response and auth, ready for a typed client in your language.

Path parameters

idstringrequired
The call id.

Try itEdit the fields and copy the request. Nothing is sent from this page.

API keykept in this tab; masked on screen, copied in full

idpath, stringrequired

curl -X GET https://api.daybookhealthcare.com/v1/calls/call_01JBX8M4Q2T7 \
  -H "Authorization: Bearer $DAYBOOK_API_KEY"

Response

idstring
Unique id, prefixed call_.
objectstring
Always call.
statusstring
Where the call is, in order: queued, dialing, navigating (the phone tree), on_hold, with_rep, then completed, failed or canceled.
payerstring
Daybook payer id.
call_typestring
The call type you asked for.
modestring
autonomous or handoff.
hold_secondsinteger
Time spent on hold so far.
claimobject
The claim, as ids only: patient_control_number as you sent it and payer_claim_number, yours or the rep's. null without a claim.
handoffobject
For a handoff call: your phone and name, and once a rep is on the line the questions and rep_name. null when autonomous.
answerobject
The structured answer. null until the call completes.
Properties
- statusstring
  What the rep said about the claim or member, normalized: for claim status, paid, denied, pending, in_process or not_on_file.
- reference_numberstring
  The call reference the rep gave.
- rep_namestring
  The rep's name as given.
- next_stepstring
  What to do next, in plain words.
- detailsobject
  Fields specific to the call type, such as denial_reason, paid_amount_cents, check_number or auth_number.
ended_reasonstring
Why a call ended short of an answer: your cancel's reason, or Daybook's in plain words (line busy, nobody answered the ring, hold ceiling passed). null otherwise.
transcript_urlstring
Signed link to the transcript. Expires after 1 hour. The same turns as Read the transcript.
recording_urlstring
Signed link to the recording.
repeat_ofstring
The first call of a repeating series, when a schedule placed this call. null otherwise.
next_run_atstring
When the next scheduled re-check runs, if the call repeats. null once the series stops.
metadataobject
Your keys, echoed back.
created_atstring
RFC 3339 timestamp.

curl -X GET https://api.daybookhealthcare.com/v1/calls/call_01JBX8M4Q2T7 \
  -H "Authorization: Bearer $DAYBOOK_API_KEY"

Response 200

{
  "id": "call_01JBX8M4Q2T7",
  "object": "call",
  "status": "completed",
  "payer": "bayline",
  "call_type": "claim_status",
  "mode": "autonomous",
  "hold_seconds": 1412,
  "claim": {
    "patient_control_number": "A-10442-1",
    "payer_claim_number": "BHP26288001144"
  },
  "handoff": null,
  "answer": {
    "status": "denied",
    "reference_number": "BHP-4471-0092",
    "rep_name": "Dana",
    "next_step": "Submit a retro authorization, then request reprocessing.",
    "details": {
      "denial_reason": "CO-197 precertification absent",
      "denied_on": "2026-10-02"
    }
  },
  "ended_reason": null,
  "transcript_url": "https://files.daybookhealthcare.com/t/call_01JBX8M4Q2T7?sig=...",
  "recording_url": null,
  "repeat_of": null,
  "next_run_at": null,
  "metadata": {
    "account": "A-10442",
    "ticket": "TCK-55821"
  },
  "created_at": "2026-10-29T14:02:11Z"
}