Start a call

POST/v1/calls

Place a call to a payer. Daybook works the phone tree, waits on hold, and returns a structured answer with the payer's reference number.

Used in Payer calls3 use cases

The whole flow, with examples, is on Payer calls; read Sandbox and payer calls before placing a call from a sandbox.

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

Body

payerstringrequired
Daybook payer id, such as bayline, keystone or meridian.
call_typestringrequired
claim_status, eligibility, prior_auth, appeal_status, payment_trace or other.
modestring
autonomous (default for the five set call types) handles the call end to end. handoff rings the biller in handoff when a rep picks up and sends call.handoff_ready.
claimobject
The claim the call is about. Required for claim_status, appeal_status and payment_trace.
Properties
- payer_claim_numberstring
  The payer's claim number (ICN), when you have it.
- patient_control_numberstring
  Your claim id as sent in CLM01.
- date_of_servicestringrequired
  First date of service, YYYY-MM-DD.
- billed_amount_centsinteger
  Total billed, in cents.
patientobjectrequired
The member.
Properties
- first_namestringrequired
- last_namestringrequired
- date_of_birthstringrequired
  YYYY-MM-DD.
- member_idstringrequired
  Member id on the insurance card.
providerobjectrequired
The provider the payer will verify.
Properties
- npistringrequired
  Billing or rendering NPI.
- tax_idstring
  Tax id, when the payer verifies by TIN.
questionsstring[]
Extra questions for the rep, asked after the standard ones for the call type.
scriptstring
Id of one of your call scripts (Worklists and rules). Daybook follows it in place of the default for the call type.
handoffobject
Who to ring in for handoff calls.
Properties
- phonestringrequired
  E.164 number Daybook bridges the rep to.
- namestring
  Biller name, for your logs.
scheduleobject
Repeat the call until something changes.
Properties
- repeat_every_daysintegerrequired
  Days between calls.
- untilstring
  status_changes (default) or a date, YYYY-MM-DD.
metadataobject
Up to 20 keys of your own: account, ticket, queue, work item. Echoed on the call and on every event about it, so your handler needs no lookup table. Ids only, never a patient's name, date of birth or member 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

payerstringrequired

call_typestringrequired

modestring

claimobject

patientobjectrequired

curl -X POST https://api.daybookhealthcare.com/v1/calls \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "payer": "bayline",
    "call_type": "claim_status",
    "claim": {
      "patient_control_number": "A-10442-1",
      "date_of_service": "2026-09-14",
      "billed_amount_cents": 48500
    },
    "patient": {
      "first_name": "Jordan",
      "last_name": "Sample",
      "date_of_birth": "1980-01-01",
      "member_id": "W000000001"
    },
    "provider": {
      "npi": "1999999984"
    },
    "schedule": {
      "repeat_every_days": 5
    },
    "metadata": {
      "account": "A-10442",
      "ticket": "TCK-55821"
    }
  }'

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 POST https://api.daybookhealthcare.com/v1/calls \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "payer": "bayline",
    "call_type": "claim_status",
    "claim": {
      "patient_control_number": "A-10442-1",
      "date_of_service": "2026-09-14",
      "billed_amount_cents": 48500
    },
    "patient": {
      "first_name": "Jordan",
      "last_name": "Sample",
      "date_of_birth": "1980-01-01",
      "member_id": "W000000001"
    },
    "provider": {
      "npi": "1999999984"
    },
    "schedule": {
      "repeat_every_days": 5
    },
    "metadata": {
      "account": "A-10442",
      "ticket": "TCK-55821"
    }
  }'

Response 200

{
  "id": "call_01JBX8M4Q2T7",
  "object": "call",
  "status": "queued",
  "payer": "bayline",
  "call_type": "claim_status",
  "mode": "autonomous",
  "hold_seconds": 0,
  "claim": {
    "patient_control_number": "A-10442-1",
    "payer_claim_number": null
  },
  "handoff": null,
  "answer": null,
  "ended_reason": null,
  "transcript_url": null,
  "recording_url": null,
  "repeat_of": null,
  "next_run_at": "2026-11-03T14:02:11Z",
  "metadata": {
    "account": "A-10442",
    "ticket": "TCK-55821"
  },
  "created_at": "2026-10-29T14:02:11Z"
}