Getting started
The Caller 9 API is a JSON REST API served from https://api.caller9.app. Everything
you can see and change in the Caller 9 studio for your organization (studios, phone
numbers, contacts, call history and live calls) is available to your own code.
1. Create an API key
Section titled “1. Create an API key”API keys belong to an organization, and only organization admins can manage them.
- Open the Caller 9 studio and go to Settings → API Keys.
- Click Create API Key, give it a name that says what will use it, and pick an access level:
- Read-only keys can only read data (
GETrequests). - Full access keys can also make changes, with the same rights as an organization admin.
- Read-only keys can only read data (
- Copy the key. It starts with
c9_and is shown only once. Store it in a secret manager or environment variable, never in client-side code or a public repository.
2. Find your organization ID
Section titled “2. Find your organization ID”Most endpoints are scoped to your organization. Its ID is a UUID shown under Settings → Organization, and also on the API Keys page.
3. Make a request
Section titled “3. Make a request”List your studios:
export CALLER9_API_KEY="c9_..."export CALLER9_ORG="your-organization-id"
curl https://api.caller9.app/v1/organizations/$CALLER9_ORG/studios \ -H "Authorization: Bearer $CALLER9_API_KEY"Or from JavaScript (server-side, e.g. Node.js or a Cloudflare Worker):
const res = await fetch( `https://api.caller9.app/v1/organizations/${process.env.CALLER9_ORG}/studios`, { headers: { Authorization: `Bearer ${process.env.CALLER9_API_KEY}` } },)if (!res.ok) throw new Error(`Caller 9 API error ${res.status}: ${(await res.json()).error}`)const { studios } = await res.json()Responses are JSON objects. Collections are wrapped in a named key (for example
{ "studios": [...] }), and single resources too (for example { "studio": {...} }).
Next steps
Section titled “Next steps”- Authentication: scopes, rotation, and what keys can’t reach.
- Errors & rate limits: how failures are reported.
- Core concepts: how studios, numbers and calls fit together.
- API reference: every endpoint.