Voice API Docs

How to connect to the service

Below is the base integration contract. Clients do not need access to provider settings, SIP details, or external identifiers.

Open status page
Connection

Base URL

https://api.voicerro.com

Authorization

All requests are signed with a single Bearer token.

Authorization: Bearer YOUR_SERVICE_API_KEY
Important

Use only internal agent keys like altynai and altai. External provider identifiers should never be needed by the integrator.

POST /v1/calls

Creates a call using a phone number and internal agent. Returns only an internal call_id.

GET /v1/calls/{call_id}

Returns normalized call status, transcript, and duration in a proprietary schema.

GET /v1/agents

Shows available internal agents that are safe to use in client apps.

POST /v1/webhooks/call-completed

Internal webhook flow for saving the final call result.

Subpage
Calls

Create a call and read call state by internal call_id.

Subpage
Agents

Internal platform agents and how to use them safely.

Subpage
Webhooks

Completion flow and final service payloads.

Quickstart
Open API Base

1. Create call

The shortest integration path: pass phone and internal agent key.

curl -X POST https://api.voicerro.com/v1/calls \
  -H "Authorization: Bearer YOUR_SERVICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+996700000000",
    "agent": "altynai"
  }'

2. Get call status

Use the internal call_id returned in the first step.

curl https://api.voicerro.com/v1/calls/YOUR_CALL_ID \
  -H "Authorization: Bearer YOUR_SERVICE_API_KEY"

3. List agents

curl https://api.voicerro.com/v1/agents \
  -H "Authorization: Bearer YOUR_SERVICE_API_KEY"

4. Webhook completion payload

POST /v1/webhooks/call-completed
{
  "event_type": "call.completed",
  "provider_call_id": "internal-provider-reference",
  "status": "completed",
  "transcript": "agent: Hello\nuser: Hi",
  "duration": 120
}
POST/v1/calls

Try create call

Ready-to-run request for a quick outbound call test through altynai.

Try API
curl -X POST https://api.voicerro.com/v1/calls \
  -H "Authorization: Bearer YOUR_SERVICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+996700000000",
    "agent": "altynai"
  }'
POST/v1/calls

Try create call with Altai

Fast test call using the internal agent key altai.

Try API
curl -X POST https://api.voicerro.com/v1/calls \
  -H "Authorization: Bearer YOUR_SERVICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+996700000000",
    "agent": "altai"
  }'
GET/v1/agents

Try list agents

Gets the public list of internal voice agents.

Try API
curl https://api.voicerro.com/v1/agents \
  -H "Authorization: Bearer YOUR_SERVICE_API_KEY"
GET/v1/calls/{call_id}

Try call status

Checks call state by the internal UUID returned during creation.

Try API
curl https://api.voicerro.com/v1/calls/YOUR_CALL_ID \
  -H "Authorization: Bearer YOUR_SERVICE_API_KEY"