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.
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.
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.
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.
| 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 |