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.
A stock check is a short call. Set max_minutes to the time you actually need. This example uses 3, so the hold is $4.50.
validate_call checks the body and returns the hold. It does not place a call and it does not charge.
Send the same questions to each store. Compare whether the item is in stock, the price, and whether they will hold it.
Example only. The number, business, and name are made up. They are not customers.
max_minutes is 3, so this call holds $4.50: $2.50 for the first minute and $1.00 for each additional minute.
{
"phone": "+1 604 555 0123",
"business_name": "Example Hardware – Main St",
"purpose": "info",
"goal": "Check whether a 3500W generator is in stock today, the price, and whether they can hold it.",
"questions": [
{
"id": "in_stock",
"ask": "Is a 3500W generator in stock today?"
},
{
"id": "price",
"ask": "What is the price of that generator?"
},
{
"id": "hold",
"ask": "Can you hold that generator, and for how long?"
}
],
"max_minutes": 3,
"on_behalf_of": "Jordan Blake",
"consent_attestation": true,
"idempotencyKey": "stock-check-example-hardware-generator",
"deadline": "2026-10-27T17:20:56.665Z"
}On the REST API, send idempotencyKey as the Idempotency-Key header.