API Documentation
Current APIs
- Agent
- Making phone calls
- Executions & calls data
- Phone numbers
- Inbound Agents
- Batches
- Knowledgebases
- Providers
- Voice
- User
Legacy APIs (deprecated)
Agent v1.0 APIs
Get All Voice AI Agent Executions API
Access all execution records for a specific agent, providing insights into performance and past interactions with Bolna APIs.
GET
/
agent
/
{agent_id}
/
executions
curl --request GET \
--url https://api.bolna.ai/agent/{agent_id}/executions \
--header 'Authorization: Bearer <token>'
[
{
"id": "4c06b4d1-4096-4561-919a-4f94539c8d4a",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batch_id": "baab7cdc833145bf8dd260ff1f0a3f21",
"conversation_time": 123,
"total_cost": 123,
"status": "completed",
"error_message": "<string>",
"answered_by_voice_mail": true,
"transcript": "<string>",
"created_at": "2024-01-23T01:14:37Z",
"updated_at": "2024-01-29T18:31:22Z",
"cost_breakdown": {
"llm": 4.2,
"network": 1.2,
"platform": 2,
"synthesizer": 6.8,
"transcriber": 0.7
},
"telephony_data": {
"duration": 42,
"to_number": "+10123456789",
"from_number": "+19876543007",
"recording_url": "https://bolna-call-recordings.s3.us-east-1.amazonaws.com/AC1f3285e7c353c7d4036544f8dac36b98/REb1c182ccde4ddf7969a511a267d3c669",
"hosted_telephony": true,
"provider_call_id": "CA42fb13614bfcfeccd94cf33befe14s2f",
"call_type": "outbound",
"provider": "twilio",
"hangup_by": "Caller",
"hangup_reason": "Normal Hangup",
"hangup_provider_code": 4000
},
"transfer_call_data": {
"provider_call_id": "CA42fb13614bfcfeccd94cf33befe14s2f",
"status": "completed",
"duration": 42,
"cost": 123,
"to_number": "+10123456789",
"from_number": "+19876543007",
"recording_url": "https://bolna-call-recordings.s3.us-east-1.amazonaws.com/AC1f3285e7c353c7d4036544f8dac36b98/REb1c182ccde4ddf7969a511a267d3c669",
"hangup_by": "Caller",
"hangup_reason": "Normal Hangup",
"hangup_provider_code": 4000
},
"batch_run_details": {
"status": "completed",
"created_at": "2024-01-23T01:14:37Z",
"updated_at": "2024-01-29T18:31:22Z",
"retried": 0
},
"extracted_data": {
"user_interested": true,
"callback_user": false,
"address": "42 world lane",
"salary_expected": "42 bitcoins"
},
"context_details": {}
}
]
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The unique id
of the agent
Response
200
application/json
List of all executions by an agent sorted by last run
The response is of type object[]
.
curl --request GET \
--url https://api.bolna.ai/agent/{agent_id}/executions \
--header 'Authorization: Bearer <token>'
[
{
"id": "4c06b4d1-4096-4561-919a-4f94539c8d4a",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batch_id": "baab7cdc833145bf8dd260ff1f0a3f21",
"conversation_time": 123,
"total_cost": 123,
"status": "completed",
"error_message": "<string>",
"answered_by_voice_mail": true,
"transcript": "<string>",
"created_at": "2024-01-23T01:14:37Z",
"updated_at": "2024-01-29T18:31:22Z",
"cost_breakdown": {
"llm": 4.2,
"network": 1.2,
"platform": 2,
"synthesizer": 6.8,
"transcriber": 0.7
},
"telephony_data": {
"duration": 42,
"to_number": "+10123456789",
"from_number": "+19876543007",
"recording_url": "https://bolna-call-recordings.s3.us-east-1.amazonaws.com/AC1f3285e7c353c7d4036544f8dac36b98/REb1c182ccde4ddf7969a511a267d3c669",
"hosted_telephony": true,
"provider_call_id": "CA42fb13614bfcfeccd94cf33befe14s2f",
"call_type": "outbound",
"provider": "twilio",
"hangup_by": "Caller",
"hangup_reason": "Normal Hangup",
"hangup_provider_code": 4000
},
"transfer_call_data": {
"provider_call_id": "CA42fb13614bfcfeccd94cf33befe14s2f",
"status": "completed",
"duration": 42,
"cost": 123,
"to_number": "+10123456789",
"from_number": "+19876543007",
"recording_url": "https://bolna-call-recordings.s3.us-east-1.amazonaws.com/AC1f3285e7c353c7d4036544f8dac36b98/REb1c182ccde4ddf7969a511a267d3c669",
"hangup_by": "Caller",
"hangup_reason": "Normal Hangup",
"hangup_provider_code": 4000
},
"batch_run_details": {
"status": "completed",
"created_at": "2024-01-23T01:14:37Z",
"updated_at": "2024-01-29T18:31:22Z",
"retried": 0
},
"extracted_data": {
"user_interested": true,
"callback_user": false,
"address": "42 world lane",
"salary_expected": "42 bitcoins"
},
"context_details": {}
}
]
Assistant
Responses are generated using AI and may contain mistakes.