Human phone calls
Tier 1 is $2.50 for the first minute and $1.00 for each additional minute. The default 5-minute hold is $6.50, and unused hold is released.
US and Canadian numbers. No recording. Consent required on every call.
Confirm the time, what to bring, and whether to arrive early. The answers come back on the question ids you send.
allowed_disclosures and shareable_contact are the only details the VA may share. Passwords, one-time codes, and other secrets are rejected.
The default window is weekday 09:00–17:00 in the recipient time zone. A call outside that window needs allow_outside_business_hours set to true after you confirm it.
Example only. The number, business, and name are made up. They are not customers.
{
"phone": "+1 312 555 0187",
"business_name": "Example Family Dental",
"purpose": "scheduling",
"goal": "Confirm Sam Lee's Thursday 10:00 appointment, what to bring, and whether to arrive early.",
"questions": [
{
"id": "confirmed",
"ask": "Is the Thursday 10:00 appointment confirmed?"
},
{
"id": "bring",
"ask": "What should Sam Lee bring to the appointment?"
},
{
"id": "arrive_early",
"ask": "Should Sam Lee arrive early, and by how long?"
}
],
"allowed_disclosures": "Appointment time, patient first name, and that this confirms a visit at Example Family Dental.",
"shareable_contact": "Example Family Dental front desk",
"allow_outside_business_hours": false,
"on_behalf_of": "Sam Lee",
"consent_attestation": true,
"idempotencyKey": "appointment-example-family-dental",
"deadline": "2026-10-27T18:19:38.284Z"
}On the REST API, send idempotencyKey as the Idempotency-Key header.