{"name":"AgentCall API","version":"1.0","description":"Phone numbers, SMS, voice calls, and AI voice calls for AI agents. Provision real phone numbers, send/receive SMS, extract OTP codes, make calls, and run autonomous AI voice conversations.","docs":"https://api.agentcall.co/docs","llmReference":"https://api.agentcall.co/llms.txt","auth":{"type":"Bearer","header":"Authorization: Bearer <AGENTCALL_API_KEY>","keyPrefix":"ac_live_"},"baseUrl":"https://api.agentcall.co","endpoints":[{"method":"POST","path":"/v1/numbers/provision","description":"Provision a new phone number","body":{"type":"local | tollfree | mobile | sim","country":"US (optional, default US)","label":"string (optional)"},"example":"{ \"type\": \"local\", \"country\": \"US\" }"},{"method":"GET","path":"/v1/numbers","description":"List all your phone numbers","query":"limit, country, type (all optional)"},{"method":"GET","path":"/v1/numbers/:id","description":"Get details of a specific number"},{"method":"DELETE","path":"/v1/numbers/:id","description":"Release (deactivate) a number — irreversible, stops billing"},{"method":"POST","path":"/v1/sms/send","description":"Send an SMS message","body":{"from":"number ID or E.164 string","to":"+E.164 recipient","body":"message text (max 1600 chars)"},"example":"{ \"from\": \"num_abc123\", \"to\": \"+14155551234\", \"body\": \"Hello!\" }"},{"method":"GET","path":"/v1/sms/inbox/:numberId","description":"Get received SMS messages for a number","query":"limit, otpOnly=true (optional)"},{"method":"GET","path":"/v1/sms/:messageId","description":"Get a specific message by ID"},{"method":"GET","path":"/v1/sms/otp/:numberId","description":"Wait for an OTP verification code to arrive (long-polls up to 60s)","query":"timeout=60000 (optional, ms)"},{"method":"POST","path":"/v1/calls/initiate","description":"Start an outbound phone call","body":{"from":"number ID or E.164","to":"+E.164 recipient","record":"boolean (optional, Pro only)"},"example":"{ \"from\": \"num_abc123\", \"to\": \"+14155551234\" }"},{"method":"POST","path":"/v1/calls/ai","description":"Start an AI voice call — the AI handles the conversation autonomously (Pro plan, $0.20/min)","body":{"from":"number ID or E.164","to":"+E.164 recipient","systemPrompt":"instructions for the AI (e.g. \"Schedule a dentist appointment for Tuesday\")","voice":"alloy | ash | ballad | coral | echo | sage | shimmer | verse (optional)","firstMessage":"what AI says first (optional)","maxDurationSecs":"number (optional, default 600)"},"example":"{ \"from\": \"num_abc123\", \"to\": \"+14155551234\", \"systemPrompt\": \"You are calling to ask about business hours.\", \"voice\": \"alloy\" }"},{"method":"GET","path":"/v1/calls","description":"List call history","query":"limit (optional)"},{"method":"GET","path":"/v1/calls/:callId","description":"Get details of a specific call"},{"method":"GET","path":"/v1/calls/:callId/transcript","description":"Get the full transcript of a completed AI voice call"},{"method":"POST","path":"/v1/calls/:callId/hangup","description":"Hang up an active call"},{"method":"POST","path":"/v1/webhooks","description":"Register a webhook endpoint for real-time events","body":{"url":"HTTPS endpoint URL","events":"['sms.inbound', 'sms.otp', 'call.inbound', 'call.ringing', 'call.status', 'call.recording', 'number.released']"}},{"method":"GET","path":"/v1/webhooks","description":"List registered webhooks"},{"method":"POST","path":"/v1/webhooks/:id/rotate","description":"Rotate webhook signing secret"},{"method":"DELETE","path":"/v1/webhooks/:id","description":"Delete a webhook"},{"method":"GET","path":"/v1/usage","description":"Get usage and cost breakdown","query":"period=YYYY-MM (optional, defaults to current month)"}],"quickstart":{"step1":"Set Authorization header: Bearer <your API key>","step2":"POST /v1/numbers/provision with { \"type\": \"local\" } to get a phone number","step3":"Use the returned number ID in SMS and call endpoints","step4":"POST /v1/sms/send to send texts, GET /v1/sms/otp/:numberId to wait for verification codes","step5":"POST /v1/calls/ai to make AI-powered voice calls with a systemPrompt"},"phoneFormat":"All phone numbers must be E.164 format: +{country code}{number}, e.g. +14155551234"}