Skip to main content
The CallingBox API is intentionally small. You can manage phone numbers, create a call, list calls, or get a specific call by ID.

​
Base URL

https://api.callingbox.io
All paths are relative to this. POST /v1/calls means POST https://api.callingbox.io/v1/calls.

​
Authentication

Every request needs a Bearer token: 
Authorization: Bearer sk_live_...
Keys start with sk_ and belong to your organization. Create them from API Keys in the dashboard.
The dashboard uses session cookies, not API keys. The Bearer token described here is for the public /v1 API only.

​
Request format

  • Request bodies are JSON (Content-Type: application/json)
  • Phone numbers use E.164 format (e.g. +15551234567)
  • Responses are JSON with standard HTTP status codes

​
Endpoints

MethodPathWhat it does
GET/v1/numbersList the phone numbers in your org
GET/v1/numbers/availableSearch for numbers available for purchase
POST/v1/numbers/purchasePurchase a phone number
POST/v1/callsCreate an outbound call
GET/v1/callsList all calls in your org
GET/v1/calls/{id}Get one call by ID
The API Reference tab in the top navigation has interactive docs with request builders.
The SDKs and future CLI are wrappers around these same /v1 endpoints. See SDKs & tools for the Python SDK and the future TypeScript SDK / CLI docs.

​
Error responses

Errors come back as JSON with an error field: 
{
  "error": "call abc123 not found"
}
StatusWhat it means
201Call created
400Bad request (missing fields, wrong format)
401Bad or missing API key
404Call not found
502Telephony provider error
Full list of call statuses and error conditions: Statuses and failures.