List calls
GET
https://app.sendapp.ai/api/voice/calls
The phone calls handled by Voice AI, newest first, one page at a time: direction, outcome, numbers, whether the AI answered or passed it to a person, duration, summary and category. The transcript is not in the list: you find it in the call detail.
Dates are in UTC, ISO 8601 (
2026-11-05T09:12:04Z); durations are whole seconds. Limit: 60 reads a minute per key.Common errors:
401 API key missing or wrong — 403 plan without API access or without Voice AI, Voice AI app switched off, account suspended — 404 call or assistant that does not exist or is not yours — 422 invalid parameters — 429 too many requests: try again after the seconds given in Retry-After.Parameters
14 · 1 required
apikey
required
Your API Key (the
X-API-Key header also works).
page
optional
Page number, from 1.
per_page
optional
Calls per page: 1 to 200 (default 50).
from
optional
Only calls started from this time (ISO 8601, e.g.
2026-11-01T00:00:00Z).
to
optional
Only calls started up to this time (ISO 8601). A date without a time (
2026-11-30) includes that whole day, in UTC; with a time the limit is exact.
direction
optional
in received calls, out calls made.
status
optional
answered answered, missed missed, live in progress.
ai_handled
optional
true only calls the AI answered.
escalated
optional
true only calls the AI passed to a person.
number
optional
Only calls from or to this number (at least 3 digits).
assistant_id
optional
Only calls of this assistant.
category
optional
Category given by the AI:
qualified, booking, info, callback, complaint, not_interested, spam, other.
callback
optional
Callbacks:
todo to do, done done.
disposition
optional
Only calls with this outcome written by the operator.
Need help with the integration? info@sendapp.live