Make AI-powered outbound phone calls, buy dedicated phone numbers, extend number leases, and look up iMessage or FaceTime capability. Supports call IDs, caller ID continuity, global phone workflows, and pay-per-call voice automation.
Use for AI phone calls, outbound voice tasks, call automation, dedicated caller ID numbers, renewing phone number leases, checking iMessage or FaceTime availability, appointment calls, reminders, surveys, support outreach, and phone-based agent workflows.
| Method | Path |
|---|---|
| POST | api/call Make an AI phone call ($0.54). Send a phone number and task, get back a call_id to track status. Returns 403 if the number is on the Do-Not-Call (DNC) list — do not retry DNC numbers. |
| GET | api/call/:id Get call status and transcript. Requires SIWX — only the wallet that paid can poll. |
| POST | api/lookup Check if a phone number has iMessage/FaceTime ($0.05 via x402). Returns a token to poll for async results. |
| GET | api/lookup/status Poll lookup status. Requires SIWX — only the wallet that paid can poll. |
| POST | api/number Buy a phone number ($20.00 via x402). Use it as outbound caller ID. |
| POST | api/number/topup Extend a phone number by 30 days from current expiry ($15.00 via x402). Top-ups stack. Anyone can top up any number. |
| GET | api/numbers List phone numbers for the authenticated wallet. Requires SIWX. |