Calls

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.

string

Filter results to calls handled by a specific agent.

string

Filter by call direction. Accepted values: "inbound" or "outbound".

string

Return calls on or after this date and time (ISO 8601, e.g. "2025-03-01T00:00:00Z").

string

Return calls on or before this date and time (ISO 8601).

integer

Number of results per page. Default: 20.

curl "https://api.boltcall.org/v1/calls?direction=inbound&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

const params = new URLSearchParams({ direction: 'inbound', limit: '20' });
const response = await fetch(`https://api.boltcall.org/v1/calls?${params}`, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
});
const { data, meta } = await response.json();

import requests

response = requests.get(
    'https://api.boltcall.org/v1/calls',
    params={'direction': 'inbound', 'limit': 20},
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
)
result = response.json()

Response

{
  "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

string

required

The unique ID of the call to retrieve.

curl https://api.boltcall.org/v1/calls/call_xyz789 \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.boltcall.org/v1/calls/call_xyz789', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
});
const call = await response.json();

import requests

call = requests.get(
    'https://api.boltcall.org/v1/calls/call_xyz789',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
).json()

Response

{
  "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"
}

Show Response fields

string

Unique call identifier.

string

ID of the agent that handled the call.

string

"inbound" or "outbound".

string

Phone number of the caller in E.164 format.

integer

Total call duration in seconds.

string

Call status: "completed", "missed", or "failed".

string

AI-detected caller sentiment: "positive", "neutral", or "negative".

string

AI-generated summary of the call.

string[]

Auto-applied tags based on call content.

string

URL to download the call recording (authenticated).

object[]

Turn-by-turn conversation. Each item has role ("agent" or "caller") and text.

string

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.

string

required

ID of the agent that will place the call.

string

required

Destination phone number in E.164 format (e.g. "+15550001111").

string

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"
  }'

const response = await fetch('https://api.boltcall.org/v1/calls/outbound', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    agent_id: 'agent_abc123',
    to: '+15550001111',
    context: 'Follow up on dental cleaning inquiry',
  }),
});
const call = await response.json();

import requests

call = requests.post(
    'https://api.boltcall.org/v1/calls/outbound',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'agent_id': 'agent_abc123',
        'to': '+15550001111',
        'context': 'Follow up on dental cleaning inquiry',
    },
).json()

Response

{
  "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.

Overview

Endpoints

List calls

Get a call

Initiate an outbound call

​List calls

​Get a call

​Initiate an outbound call

List calls

Get a call

Initiate an outbound call