POST /v1/calls. You define what data you want back in a returns schema, and you get it as typed JSON. If you want real-time delivery, pass a webhook_url and CallingBox POSTs the result to your server when the call wraps up. There’s also a dashboard at app.callingbox.io for watching calls, managing numbers, and keeping an eye on usage.
Get started
Quickstart
Get an API key and place your first call in five minutes.
Call flow
What happens between your POST request and the JSON you get back.
SDKs & tools
Python SDK
Install the Python package, point it at production or local development, and make calls with typed responses.
TypeScript SDK
A stable place for the upcoming TypeScript client and how it will fit into the same
/v1 API model.CLI
A future command-line workflow for local testing, scripting, and CI.
Learn the model
Calls
Every request field, with examples for common use cases.
Structured results
Define a returns schema and get typed JSON from the transcript.
Delivery
Get results via polling or webhooks.
Statuses and failures
What each status means and how to handle errors.
Account
API keys
Create and revoke keys for the public API.
Numbers
Get phone numbers and manage caller IDs.
Usage and billing
Check your balance, see usage charts, and buy more credits.
Dashboard
See active calls, play back recordings, and dig into call details.