Base URL
Authentication
Every request needs anX-Api-Key header. Create keys under Settings → Developer → API keys (Scale plan, admins only) — see Authentication.
Conventions
- All request and response bodies are JSON.
- Timestamps are ISO 8601 strings.
- List endpoints return a plain JSON array — there’s no pagination envelope; use each endpoint’s own
limit/filter query parameters to bound results. - Fields on a resource are camelCase (e.g.
durationSeconds,hasRecording), even where the underlying data is stored differently. - A key only ever sees the account that created it — there is no cross-account access, by key or otherwise.
- Each key has permissions: Read, Calls, Agents or Full (new keys default to Read + Calls). A request the key isn’t allowed to make returns
403. - Billing, team, profile, sign-in and API-key endpoints can’t be called with any key, including Full.
Authentication
Generate a key and see request examples in cURL, Node, and Python.

