Pay as you go EXAMPLE PRICING · numbers $X/mo · calls $0.0X/min · texts $0.00X each · in-app messaging free · no monthly plan
MOCKUP · EXAMPLE DATA

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

EventWhen
call.answeredCallee picked up
call.transcriptEach finalized utterance
call.endedCall finished, with duration & cost
{ "type": "call.transcript", "call_id": "call_8f2k",
  "speaker": "callee", "text": "Yes, 10am works." }

MCP tools

ToolDescription
place_callStart an outbound call with a prompt
answer_callTake an inbound call on your number
get_transcriptFetch 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.