The Calls API gives you access to your complete call history — including transcripts, recordings, sentiment analysis, and AI-generated summaries — and lets you programmatically place outbound calls from any agent.
List calls Returns a paginated list of call records. Use query parameters to filter by agent, direction, or date range.
Filter results to calls handled by a specific agent.
Filter by call direction. Accepted values: "inbound" or "outbound".
Return calls on or after this date and time (ISO 8601, e.g. "2025-03-01T00:00:00Z").
Return calls on or before this date and time (ISO 8601).
Number of results per page. Default: 20.
curl "https://api.boltcall.org/v1/calls?direction=inbound&limit=20" \ -H "Authorization: Bearer YOUR_API_KEY"
{ "data" : [ { "id" : "call_xyz789" , "agent_id" : "agent_abc123" , "direction" : "inbound" , "caller" : "+1987654321" , "duration_seconds" : 142 , "status" : "completed" , "sentiment" : "positive" , "recording_url" : "https://api.boltcall.org/v1/calls/call_xyz789/recording" , "transcript_url" : "https://api.boltcall.org/v1/calls/call_xyz789/transcript" , "created_at" : "2025-03-20T09:15:00Z" } ], "meta" : { "page" : 1 , "limit" : 20 , "total" : 156 } }
Get a call Returns full details for a single call, including the turn-by-turn transcript and AI summary.
Path parameter The unique ID of the call to retrieve.
curl https://api.boltcall.org/v1/calls/call_xyz789 \ -H "Authorization: Bearer YOUR_API_KEY"
{ "id" : "call_xyz789" , "agent_id" : "agent_abc123" , "direction" : "inbound" , "caller" : "+1987654321" , "duration_seconds" : 142 , "status" : "completed" , "sentiment" : "positive" , "summary" : "Caller requested appointment for Friday." , "tags" : [ "appointment" , "new-customer" ], "recording_url" : "https://..." , "transcript" : [ { "role" : "agent" , "text" : "Hello, thanks for calling..." }, { "role" : "caller" , "text" : "Hi, I'd like to book..." } ], "created_at" : "2025-03-20T09:15:00Z" }
ID of the agent that handled the call.
Phone number of the caller in E.164 format.
Total call duration in seconds.
Call status: "completed", "missed", or "failed".
AI-detected caller sentiment: "positive", "neutral", or "negative".
AI-generated summary of the call.
Auto-applied tags based on call content.
URL to download the call recording (authenticated).
Turn-by-turn conversation. Each item has role ("agent" or "caller") and text.
ISO 8601 timestamp when the call started.
Initiate an outbound call Places an outbound call from an agent to a specified phone number. The agent uses the optional context to brief itself before the call.
ID of the agent that will place the call.
Destination phone number in E.164 format (e.g. "+15550001111").
Briefing context shown to the agent before it dials. Use this to provide lead details, appointment reminders, or campaign instructions.
Outbound calls are placed immediately on receiving the request. Ensure the agent is in "active" status before calling this endpoint.
curl -X POST https://api.boltcall.org/v1/calls/outbound \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "agent_abc123", "to": "+15550001111", "context": "Follow up on dental cleaning inquiry" }'
{ "id" : "call_out001" , "status" : "ringing" , "agent_id" : "agent_abc123" , "to" : "+15550001111" , "created_at" : "2025-03-20T14:30:00Z" }
Subscribe to the call_completed webhook event to receive the full call result when it ends.