Pay as you go EXAMPLE PRICING · numbers $X/mo · calls $0.0X/min · texts $0.00X each · in-app messaging free · no monthly plan
VoiRelay API v1
Base URL: https://api.voirelay.example
Authentication
Send your API key as a bearer token.
Authorization: Bearer vr_live_••••••••••••3f9a
POST /v1/calls
Place an outbound call handled by your agent.
{
"to": "+15550142", "from": "+15550100",
"agent_webhook": "https://myagent.example/voice",
"voice_prompt": "You are a friendly scheduling assistant.",
"max_minutes": 5, "record": true
}
→ 201 { "id": "call_8f2k", "status": "queued" }GET /v1/calls/{id}
{ "id": "call_8f2k", "status": "completed", "duration_sec": 94,
"cost": "0.0X", "transcript_url": "/v1/calls/call_8f2k/transcript" }POST /v1/numbers
{ "area_code": "555", "capabilities": ["voice","sms"],
"e911_address": { "street": "123 Example St", "city": "Exampleville", "state": "NY", "zip": "10001" } }
→ 201 { "number": "+15550177", "monthly": "X.XX" }Webhooks
| Event | When |
|---|---|
call.answered | Callee picked up |
call.transcript | Each finalized utterance |
call.ended | Call finished, with duration & cost |
{ "type": "call.transcript", "call_id": "call_8f2k",
"speaker": "callee", "text": "Yes, 10am works." }MCP tools
| Tool | Description |
|---|---|
place_call | Start an outbound call with a prompt |
answer_call | Take an inbound call on your number |
get_transcript | Fetch a call transcript |
911 & compliance
Numbers with outbound calling need a validated E911 address. Outbound caller ID is STIR/SHAKEN signed. Automated/AI calls and texts must have TCPA consent; SMS requires carrier (10DLC) registration.