Core resources

Calls

Start web (browser) calls, read call records, transcripts, recordings, the per-turn event timeline, and analytics. Outbound phone calls are started via the Phone numbers → dial endpoint.

POST/calls calls:write

Start a web call

Create a browser call to an assistant. Returns a LiveKit room token + websocket URL to connect from the client.

Body

agentId*	uuid	Assistant to run.
metadata	object	Arbitrary metadata stored on the call.

Example request

bash

curl -X POST https://api.bolchoai.in/v1/calls -H "Authorization: Bearer $VOXA_API_KEY" -H "Content-Type: application/json" \
  -d '{ "agentId": "'$AGENT_ID'" }'

Response

json

{ "callId": "c1…", "room": "call_…", "token": "<livekit-jwt>", "wsUrl": "wss://…livekit.cloud" }

GET/calls calls:read

List calls

List calls, newest first. Filter by status or assistant.

Query parameters

limit	number	Page size.
offset	number	Offset.
agentId	uuid	Filter by assistant.
status	string	queued \| in_progress \| completed \| failed.

Example request

bash

curl "https://api.bolchoai.in/v1/calls?limit=20" -H "Authorization: Bearer $VOXA_API_KEY"

GET/calls/{id} calls:read

Get call

Full call record: status, end reason, duration, cost breakdown, summary, structured data, TTS-cache savings, and the transcript turns.

Path parameters

id*

uuid

Call id.

Example request

bash

curl https://api.bolchoai.in/v1/calls/$ID \
  -H "Authorization: Bearer $VOXA_API_KEY"

GET/calls/{id}/events calls:read

Get event timeline

The ordered event stream for session replay — turn latencies, tool calls, speech events.

Path parameters

id*

uuid

Call id.

Example request

bash

curl https://api.bolchoai.in/v1/calls/$ID/events \
  -H "Authorization: Bearer $VOXA_API_KEY"

GET/calls/{id}/recording calls:read

Get recording URL

A short-lived signed URL to the call audio recording.

Path parameters

id*

uuid

Call id.

Example request

bash

curl https://api.bolchoai.in/v1/calls/$ID/recording \
  -H "Authorization: Bearer $VOXA_API_KEY"

Response

json

{ "url": "https://…?signature=…" }

GET/calls/analytics analytics:read

Analytics rollup

Daily time-series + totals: calls, minutes, cost, success rate, latency (avg/p95), TTS-cache savings, and outcome breakdown.

Query parameters

days

number

Window in days (default 14).

Example request

bash

curl https://api.bolchoai.in/v1/calls/analytics \
  -H "Authorization: Bearer $VOXA_API_KEY"

POST/calls/search calls:read

Search calls

Search calls by transcript content and filters.

Example request

bash

curl -X POST https://api.bolchoai.in/v1/calls/search \
  -H "Authorization: Bearer $VOXA_API_KEY"