Pull your call data and AI analysis into your own systems — a warehouse, a BI dashboard, a CRM, or a nightly report.

A REST API over HTTPS returning JSON. If you are looking to ask questions in plain language instead, see the Vaspian Call Intelligence MCP connector.


Interactive reference

The full, always-current reference — every parameter, every field, with a Try it button — lives at:

https://ca.vaspian.ai/api/public/v1/docs

That page is generated from the running service, so it is never out of date. Use this page for orientation and that one for detail.


Getting credentials

An administrator creates them in Call Analytics under Settings → API & MCP Connections → Register integration. You choose a name, which permissions it gets, and how long it lasts.

<aside> ⚠️

The client secret is shown once, at the moment you create it. It is never stored and cannot be recovered or emailed — copy it somewhere safe immediately. If it is lost, register a new integration.

</aside>

Credentials can be given an expiry date. You will be emailed a warning before one lapses, and again if it does. There is no renewal — an expired credential is replaced by registering a new one.


Authenticating

Exchange your client ID and secret for an access token, then send that token as a Bearer header on every request.

Base URL https://ca.vaspian.ai/api/public/v1
Token endpoint POST /auth/token
Header Authorization: Bearer <token>

Send the client ID and secret in the request body, not the URL. Tokens are short-lived — request a new one when it expires rather than caching it indefinitely. Any standard OAuth2 client-credentials library will work.


Endpoints

Endpoint What it returns Permission
POST /auth/token An access token, from your client ID and secret
GET /calls Calls in a date range, newest first, with summary and AI analysis calls:read
GET /calls/{id} One call in full calls:read
GET /calls/{id}/transcript The verbatim transcript, as speaker turns transcripts:read
GET /calls/{id}/recording A time-limited download link for the audio recordings:read
PATCH /calls/{id}/attention Resolve or re-open a flagged call calls:write
GET /analytics/summary Totals and trends for a period — no per-call content analytics:read
GET /contacts Your contact directory — names and numbers contacts:read
GET /staff Your staff seats and their extensions staff:read
GET /staff/{extension}/action-items Follow-up items for one staff member, newest call first calls:read