Developers

Build on Voxbi's REST API

Voxbi exposes a REST API and webhooks for the whole phone system: authenticate a user, read their PBX context, start and hang up calls, pull call history with recordings and AI transcripts, order numbers, and get events pushed to your app. Standard HTTP and JSON, token-based auth, documented and ready to run in Postman.

  • REST and JSON
  • Token-based auth
  • Public Postman docs
The Voxbi call history with an AI transcription, the kind of call data the API exposes.

When your phone system is a black box

Call data stays locked in

Who called, what was said, what was recorded: it all lives in the phone system, out of reach of the apps your team actually works in.

Telephony is glued on by hand

Without an API, wiring calls into your own software means brittle workarounds, or no integration at all.

Manual work an API could automate

Dialing, logging, and pulling recordings by hand is the kind of repetitive work code should be doing for you.

How the API works

  1. Get a token

    Authenticate a user with email and password, or with a passwordless email code, to receive a Bearer token for the API.

  2. Call the endpoints

    Read the user and PBX context, start or hang up calls, and pull call history with recordings and AI transcripts, over standard HTTP and JSON.

  3. Subscribe to webhooks

    Register webhooks so your app reacts to calls as they happen, no polling required.

What the API gives you

Token-based authentication

Classic email and password, or passwordless email code. Both return a Bearer token you send on every protected request.

User and PBX context

One call to the /me endpoint returns the user profile, extensions, groups, WebRTC configuration, and caller identities to bootstrap your client.

Call control

Start a call from a user to any destination, place a multicast announcement, or hang up an active call, all over the API.

Call history and events

Read a call in full: caller, receivers, call-flow events, recording metadata, and AI processing fields.

Recordings and AI transcripts

Fetch a call recording by path, and pull the AI transcription and call timeline as text your app can store or search.

Webhooks

Get call events pushed to your endpoint as they happen, so your systems stay in sync without polling.

Standard REST, documented and ready to run

Everything is standard HTTP and JSON with token-based (Bearer) authentication, so you can call it from any language. The core API lives under https://cockpit.voxbi.com/v1/api, with a separate PBX APIs collection for call control, and you can order phone numbers and push PBX configuration over the API too.

The full public reference, with endpoints, authentication, examples, and a Postman collection you can run against your own account, is at docs.voxbi.com.

Frequently asked questions

Is the API public?

Yes. The full reference, endpoints, authentication, and examples, is published at docs.voxbi.com, with a Postman collection you can run against your account.

How do I authenticate?

Log in with email and password, or with a passwordless email code, to get a Bearer token. You send that token in the Authorization header on every protected request.

What can I build with it?

Anything that reads or drives calls: click-to-call from your own app, caller pop, call logging, recording and AI-transcript retrieval, number ordering, and live event handling through webhooks.

Can I connect it to my CRM?

Yes. The API is how Voxbi fits any CRM that does not already have a native integration. See the CRM integration page for what that looks like.

What is the base URL?

The core API is under https://cockpit.voxbi.com/v1/api, with a separate PBX APIs collection for call control. Both are documented at docs.voxbi.com.

Start building with Voxbi.

Read the API docs to see every endpoint, or start a free trial to get an account to build against.