Calls & transcripts
Read call outcomes, transcripts, summaries, structured data and recordings over REST or MCP — every call is a structured record you can pull headless.
Calls & transcripts
Every call your agent places becomes a structured record. You list and inspect them over REST, MCP, or CLI — the dashboard reads the same data. Nothing is locked behind the UI.
REST base: https://api.agoralia.app/api/v1 — auth header X-API-Key: ag_....
List calls
curl https://api.agoralia.app/api/v1/calls?limit=20 \
-H "X-API-Key: ag_..."Optional filters: campaign_id, status. Results are cursor-paginated (pass cursor to page),
newest first. List rows carry: id, campaign_id, status, direction, duration_seconds,
outcome, to_number, from_number, created_at, ended_at.
list_calls(limit=50)
search_calls(query="interested")Inspect one call
curl https://api.agoralia.app/api/v1/calls/<CALL_ID> \
-H "X-API-Key: ag_..."The call detail returns the full record:
| Field | What it is |
|---|---|
id, campaign_id | identifiers |
status | call lifecycle (queued, ringing, completed, failed, …) |
direction | outbound / inbound |
duration_seconds | call length |
outcome | normalized result (answered, interested, callback, do-not-call, …) |
to_number, from_number | endpoints |
summary | one-paragraph recap of the call |
analysis | model analysis of the conversation |
structured_data | fields extracted per your analysis_config |
success_evaluation | pass/fail against the campaign's success criteria |
ended_reason | why the call ended |
transcript | full turn-by-turn transcript |
recording_url | signed audio URL — present only when recording was enabled and allowed |
metadata | the caller variables you passed in |
created_at, ended_at | timestamps |
get_call(call_id="<CALL_ID>") # full record
get_call_transcript(call_id="<CALL_ID>") # transcript only
get_call_analysis(call_id="<CALL_ID>") # summary + analysis + structured data
get_call_recording_url(call_id="<CALL_ID>") # signed recording URL (if enabled)Recordings
recording_url is populated only when recording was on and the destination country allows it.
Some countries forbid recording — it is auto-disabled there and no audio is stored, but
transcript, summary, and structured_data are still produced. See
Compliance for how recording is enforced per country.
transcript, summary, analysis, and structured_data do not depend on recording — you get
them even when audio is off. Recording only adds the audio file.
Campaign results in one call
To pull a whole campaign's results (with transcripts, summaries, analysis and recordings) in a single paginated stream:
curl https://api.agoralia.app/api/v1/campaigns/<CAMPAIGN_ID>/results?limit=50 \
-H "X-API-Key: ag_..."Next steps
Messaging (SMS & WhatsApp)
Send SMS and WhatsApp from your own numbers — multi-provider BYO routing, the POST /sms endpoint, the send_message MCP tool, and conversation history.
Analytics & reports
Daily stats, per-call reports and rollups — available over MCP and REST so an agent can read its own results and act on them.