Retrieve voice AI execution API
Fetch details of a specific phone call execution by its ID using Bolna APIs. This includes information such as conversation time, status, and telephony data.
Status lifecycle
A call moves through these statuses. Always wait forcompleted (or a hard-failure terminal) before reading conversation_duration, total_cost, recording_url, or extracted_data — these fields are null or 0 until then.
status is the call’s lifecycle state. To know what happened to the call, read termination_reason; see Termination reasons.
Completed execution example
summary field and the General > Call Summary entry in extracted_data are populated only when the agent’s call_summary_enabled toggle is on (off by default). The Call Summary entry carries only a subjective value — the confidence, reasoning, and objective fields of regular extractions do not apply to it.
For graph agents, node_extracted_data holds the values the agent’s edges collected during the call, the latest value per key, for example {"availability": "Yes", "callback_hour": 18}. It is null for other agents. See Inline data extraction.
Production pattern: webhook instead of polling
For production workloads, setwebhook_url on your agent and Bolna will POST the execution payload to you automatically — no polling needed. Whitelist source IPs 13.203.39.153, 13.126.9.249 and 13.202.133.53. See Webhooks.
Authorizations
Response
Retrieve specific execution by an agent
id of the agent version that ran the call. null for calls made before versions were recorded on each call.
"7e775357-d9d3-4c82-a7d7-b7c3346caf79"
Current status of the call. Typical progression: queued → initiated → ringing → in-progress → call-disconnected → completed. Important: call-disconnected fires the instant the line drops, before duration, cost, recording URL, and extracted_data are finalized. The true terminal state is completed (or no-answer, busy, failed, canceled, stopped, error, balance-low). Always wait for completed before reading those fields.
scheduled, queued, rescheduled, initiated, ringing, in-progress, call-disconnected, completed, balance-low, busy, no-answer, canceled, failed, stopped, error What happened to the call attempt, whether or not it was placed. null while the call is in progress and for executions created before it was introduced on 26 October 2026. See Termination reasons.
user_hung_up, agent_ended_call, call_transferred, inactivity_timeout, max_duration_reached, voicemail_reached, agent_llm_error, agent_transcription_error, agent_voice_error, agent_realtime_error, agent_network_error, destination_hung_up, no_answer, dial_timeout, abandoned, ivr_not_completed, busy, declined, invalid_number, number_unreachable, network_error, number_blocked, insufficient_balance, provider_account_balance, account_suspended, rate_limited, concurrency_limit_reached, caller_id_rejected, inbound_not_allowed, provider_error, platform_error, canceled_via_api, unknown "user_hung_up"