What exactly Boltcall offers?

Boltcall gives local businesses a complete AI system that handles all the stuff that keeps slipping through the cracks. It replies to new leads in seconds, answers calls and messages, books appointments directly on your calendar, and follows up automatically so no one gets forgotten. It also sends reminders, updates you in real time, and keeps conversations moving even when you're busy or closed.

Can it transfer the call to a real person?

Yes. Set live-transfer rules (e.g., during business hours, hot leads only). If no one answers, it books or takes a voicemail and alerts you.

How good is the call quality and voice?

Natural and clear. You pick a voice and tone (friendly, calm, formal). We keep replies short so calls feel human, not robotic.

Can it use my current phone number?

Yes. You can forward your existing number to your AI receptionist, or buy a new number inside the app and start fresh.

Boltcall is speed-to-lead software for law firms. It uses AI to answer intake calls, recover missed calls, qualify leads, book consultations, and follow up automatically before callers move to a competing firm.

Is Boltcall an AI or a human answering service?

Boltcall is a fully automated AI service. There are no human receptionists involved. The platform uses conversational AI to answer calls, qualify leads, and book appointments automatically — 24 hours a day, 7 days a week, with no staffing costs or hold times.

How much does Boltcall cost?

Boltcall starts at $549 per month for the Starter plan. The Pro plan is $897 per month. All plans include unlimited AI call answering, appointment booking, lead capture, and follow-up texts with no per-call fees. Enterprise pricing is available for multi-location businesses.

What types of businesses use Boltcall?

Boltcall serves local service businesses including HVAC companies, plumbers, dentists, law firms, med spas, roofing contractors, and solar installers. Any business that receives phone inquiries and needs to respond quickly benefits from Boltcall's speed-to-lead automation.

How does the speed-to-lead system work?

Boltcall's speed-to-lead system automatically responds to every new lead within seconds — answering calls, replying to web form submissions, and sending follow-up texts without any human action required. Research shows the first business to respond wins the customer 78% of the time. Boltcall makes that response automatic and instant, even at 2am on weekends.

Boltcall GiveawayEnter to win 30 days of Boltcall.

Enter Giveaway

Boltcall GiveawayEnter to win 30 days of Boltcall.

Enter Giveaway

REST API v1

Boltcall API Documentation

Integrate AI voice agents, calls, leads, and messaging into your apps with our simple REST API.

This documentation is a complete guide to integrating Boltcall's REST API — authenticate with a key, trigger AI voice agents, and manage calls, leads, and messaging directly from your own systems.

Get API Key

How to Get Started with the Boltcall API

Get your API key

Generate a key from Settings → API Keys in your dashboard.

Make your first call

Use any HTTP client to call the API with your key.

Listen for events

bash

curl -X GET https://api.boltcall.org/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Understanding API Authentication Methods

All API requests require a Bearer token in the Authorization header. Generate keys in your dashboard under Settings \u2192 API Keys.

http

Authorization: Bearer sk_live_abc123def456...

Live keys

Prefixed with sk_live_. Use in production. All actions are real.

Test keys

Prefixed with sk_test_. Safe for development. No calls are placed.

Keep your keys secure

Never expose API keys in client-side code or public repositories. Use environment variables and server-side requests.

Base URL & Rate Limits

text

https://api.boltcall.org/v1

Plan	Rate Limit	Burst
Starter	60 requests / minute	10
Pro	300 requests / minute	50
Elite	1,000 requests / minute	200

Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response.

Endpoint Reference

Complete list of available API endpoints organized by resource.

Agents

Create, configure, and manage your AI voice agents.

GET/v1/agents

List all agents in your workspace.

Query Parameters

Name	Type	Required	Description
page	integer	optional	Page number (default: 1)
limit	integer	optional	Items per page (default: 20, max: 100)

Response

json

{
  "data": [
    {
      "id": "agent_abc123",
      "name": "Front Desk Agent",
      "voice_id": "voice_sarah",
      "status": "active",
      "phone_number": "+1234567890",
      "created_at": "2025-01-15T08:30:00Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 3 }
}

POST/v1/agents

Create a new AI agent.

Request Body

Field	Type	Required	Description
name	string	required	Display name for the agent
voice_id	string	required	Voice to use (see Voice Library)
greeting	string	optional	Custom greeting message
prompt	string	optional	System prompt / persona instructions
knowledge_base_id	string	optional	Linked knowledge base ID

Response

json

{
  "id": "agent_def456",
  "name": "After-Hours Agent",
  "voice_id": "voice_james",
  "status": "active",
  "created_at": "2025-03-20T14:00:00Z"
}

PATCH/v1/agents/:agent_id

Update an existing agent.

Request Body

Field	Type	Required	Description
name	string	optional	Updated display name
greeting	string	optional	Updated greeting message
status	string	optional	"active" or "paused"

Response

json

{
  "id": "agent_def456",
  "name": "After-Hours Agent v2",
  "status": "active",
  "updated_at": "2025-03-21T10:00:00Z"
}

DELETE/v1/agents/:agent_id

Delete an agent. This cannot be undone.

Response

json

{ "deleted": true }

Calls

Access call history, recordings, and transcripts.

GET/v1/calls

List call records with optional filters.

Query Parameters

Name	Type	Required	Description
agent_id	string	optional	Filter by agent
direction	string	optional	"inbound" or "outbound"
from	string	optional	ISO 8601 start date
to	string	optional	ISO 8601 end date
limit	integer	optional	Items per page (default: 20)

Response

json

{
  "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/v1/calls/:call_id

Get detailed information for a single call.

Response

json

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

POST/v1/calls/outbound

Initiate an outbound call from an agent.

Request Body

Field	Type	Required	Description
agent_id	string	required	Agent to place the call
to	string	required	Phone number in E.164 format
context	string	optional	Briefing context for the agent

Response

json

{
  "id": "call_out001",
  "status": "ringing",
  "agent_id": "agent_abc123",
  "to": "+1555000111",
  "created_at": "2025-03-20T14:30:00Z"
}

Leads

Manage leads captured from calls, forms, and ads.

GET/v1/leads

List all leads with filtering and sorting.

Query Parameters

Name	Type	Required	Description
status	string	optional	"new", "contacted", "qualified", "converted"
source	string	optional	"call", "sms", "form", "facebook", "google"
sort	string	optional	Field to sort by (default: created_at)
limit	integer	optional	Items per page (default: 20)

Response

json

{
  "data": [
    {
      "id": "lead_001",
      "name": "Jane Smith",
      "phone": "+1555123456",
      "email": "jane@example.com",
      "status": "new",
      "source": "call",
      "score": 85,
      "tags": ["high-intent", "dental-cleaning"],
      "created_at": "2025-03-20T10:00:00Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 42 }
}

POST/v1/leads

Create a lead manually.

Request Body

Field	Type	Required	Description
name	string	required	Full name
phone	string	optional	Phone number (E.164)
email	string	optional	Email address
source	string	optional	Lead source label
tags	string[]	optional	Tags for segmentation

Response

json

{
  "id": "lead_002",
  "name": "John Doe",
  "status": "new",
  "created_at": "2025-03-20T11:30:00Z"
}

Messages

Send and receive SMS, WhatsApp, and email messages.

POST/v1/messages/sms

Send an SMS message.

Request Body

Field	Type	Required	Description
to	string	required	Recipient phone number (E.164)
body	string	required	Message content (max 1600 chars)
from_number	string	optional	Sender number (defaults to workspace number)

Response

json

{
  "id": "msg_sms001",
  "channel": "sms",
  "status": "sent",
  "to": "+1555000111",
  "created_at": "2025-03-20T15:00:00Z"
}

POST/v1/messages/whatsapp

Send a WhatsApp message.

Request Body

Field	Type	Required	Description
to	string	required	Recipient phone number (E.164)
template	string	required	Approved template name
variables	object	optional	Template variable values

Response

json

{
  "id": "msg_wa001",
  "channel": "whatsapp",
  "status": "sent",
  "to": "+1555000111",
  "created_at": "2025-03-20T15:05:00Z"
}

GET/v1/messages

List message history across all channels.

Query Parameters

Name	Type	Required	Description
channel	string	optional	"sms", "whatsapp", or "email"
lead_id	string	optional	Filter by lead
limit	integer	optional	Items per page (default: 20)

Response

json

{
  "data": [
    {
      "id": "msg_sms001",
      "channel": "sms",
      "direction": "outbound",
      "to": "+1555000111",
      "body": "Thanks for calling! Your appointment is confirmed.",
      "status": "delivered",
      "created_at": "2025-03-20T15:00:00Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 89 }
}

Appointments

Manage appointments booked by your AI agents.

GET/v1/appointments

List all appointments.

Query Parameters

Name	Type	Required	Description
status	string	optional	"upcoming", "completed", "cancelled"
agent_id	string	optional	Filter by booking agent
from	string	optional	ISO 8601 start date
to	string	optional	ISO 8601 end date

Response

json

{
  "data": [
    {
      "id": "apt_001",
      "lead_id": "lead_001",
      "agent_id": "agent_abc123",
      "title": "Dental Cleaning",
      "start_time": "2025-03-25T10:00:00Z",
      "end_time": "2025-03-25T11:00:00Z",
      "status": "upcoming",
      "created_at": "2025-03-20T09:20:00Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 12 }
}

DELETE/v1/appointments/:appointment_id

Cancel an appointment.

Response

json

{ "id": "apt_001", "status": "cancelled" }

Webhooks

Subscribe to real-time events from your workspace.

GET/v1/webhooks

List all registered webhook endpoints.

Response

json

{
  "data": [
    {
      "id": "wh_001",
      "url": "https://yourapp.com/hooks/boltcall",
      "events": ["call.completed", "lead.created"],
      "status": "active",
      "created_at": "2025-02-10T12:00:00Z"
    }
  ]
}

POST/v1/webhooks

Request Body

Field	Type	Required	Description
url	string	required	HTTPS endpoint URL
events	string[]	required	Event types to subscribe to
secret	string	optional	Signing secret for verification

Response

json

{
  "id": "wh_002",
  "url": "https://yourapp.com/hooks/boltcall",
  "events": ["call.completed", "lead.created", "appointment.booked"],
  "status": "active",
  "secret": "whsec_abc123...",
  "created_at": "2025-03-20T16:00:00Z"
}

DELETE/v1/webhooks/:webhook_id

Remove a webhook subscription.

Response

json

{ "deleted": true }

Analytics

Retrieve usage metrics and performance analytics.

GET/v1/analytics/overview

Get a summary of key metrics for a date range.

Query Parameters

Name	Type	Required	Description
from	string	required	ISO 8601 start date
to	string	required	ISO 8601 end date

Response

json

{
  "period": { "from": "2025-03-01", "to": "2025-03-31" },
  "calls": { "total": 487, "answered": 472, "missed": 15 },
  "leads": { "captured": 89, "qualified": 34, "converted": 12 },
  "messages": { "sent": 312, "delivered": 308 },
  "appointments": { "booked": 56, "completed": 48, "cancelled": 8 },
  "avg_response_time_seconds": 4.2
}

GET/v1/analytics/usage

Get token and minute usage for billing period.

Response

json

{
  "billing_period": { "from": "2025-03-01", "to": "2025-03-31" },
  "minutes_used": 1243,
  "minutes_limit": 2000,
  "sms_sent": 312,
  "sms_limit": 500,
  "api_calls": 4521
}

Webhook Events

Subscribe to these events to receive real-time POST requests at your webhook URL. Each payload includes an event field and a data object with the full resource.

Event	Description
`call.started`	An inbound or outbound call has started
`call.completed`	A call has ended (includes transcript & recording URLs)
`call.missed`	An inbound call was not answered
`lead.created`	A new lead was captured
`lead.updated`	Lead status or details were changed
`appointment.booked`	An appointment was scheduled
`appointment.cancelled`	An appointment was cancelled
`message.received`	An inbound SMS or WhatsApp message arrived
`message.delivered`	An outbound message was delivered

Example webhook payload

json

{
  "event": "call.completed",
  "timestamp": "2025-03-20T09:17:22Z",
  "data": {
    "id": "call_xyz789",
    "agent_id": "agent_abc123",
    "direction": "inbound",
    "caller": "+1987654321",
    "duration_seconds": 142,
    "status": "completed",
    "sentiment": "positive",
    "summary": "Caller requested appointment for Friday.",
    "recording_url": "https://api.boltcall.org/v1/calls/call_xyz789/recording"
  }
}

Error Codes

All errors follow a consistent structure with an HTTP status code and a JSON body.

json

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid or expired.",
    "status": 401
  }
}

Status	Code	Description
400	`bad_request`	The request body is malformed or missing required fields.
401	`invalid_api_key`	API key is missing, invalid, or expired.
403	`forbidden`	Your key does not have permission for this resource.
404	`not_found`	The requested resource does not exist.
409	`conflict`	The resource already exists or has a conflicting state.
422	`validation_error`	Request data failed validation. Check the error message.
429	`rate_limited`	Too many requests. Back off and retry with exponential delay.
500	`internal_error`	Something went wrong on our end. Contact support if it persists.

SDKs & Libraries

Node.js

npm install @boltcall/sdk

Python

pip install boltcall

cURL

Works out of the box

Node.js example

javascript

import Boltcall from '@boltcall/sdk';

const client = new Boltcall({ apiKey: process.env.BOLTCALL_API_KEY });

// List agents
const agents = await client.agents.list();
console.log(agents.data);

// Initiate an outbound call
const call = await client.calls.create({
  agent_id: 'agent_abc123',
  to: '+1555000111',
  context: 'Follow up on dental cleaning inquiry',
});
console.log('Call started:', call.id);

Ready to integrate?

Get your API key and start building with Boltcall in minutes. Free tier includes 100 API calls per day.

Get API Key Contact Sales