Phone numbers, AI voice calls, SMS for agents.
Communications
Endpoints · 14
x402 URLhttps://x402.monid.ai/v1/run
EndpointDescriptionPrice
GET/get-numbers/{id}FreeGet one of your numbers WITH its live AI persona (instructions, voice, model, call controls, compliance) in one call.
GET/list-languagesFreeList the spoken languages an assistant can use (code + name).
POST/release-numbers/{id}FreeStop renewing a phone number; it stays active until its paid-through date.
POST/place-calls$0.005per secondPlace an outbound AI phone call from your number. Stop the run to hang up.
GET/list-voicesFreeList the TTS voices an assistant can speak with (id, name, gender, language).
POST/provision-numbers$2.00Buy a real US phone number (local or toll-free) with its AI persona.
GET/calls/{id}FreeGet one call by id — direction, status, duration, timestamps.
GET/calls/{id}/transcriptFreeFetch the transcript of a call placed from your number.
GET/list-messagesFreeList the SMS messages sent from or received on a number you own.
POST/send-messages$0.03Send an SMS from a phone number you own. Opted-out recipients (STOP) are blocked automatically.
PATCH/update-numbers/{id}FreeUpdate a phone number you own — its AI persona (instructions, name, language, voice, model, call controls, compliance disclosure, SMS auto-reply).
GET/calls/{id}/recordingFreeGet a download URL for the recording of a call placed from your number.
GET/list-numbersFreeList the phone numbers you own (with state, renewal, and persona).
GET/list-callsFreeList the call history of a number you own — inbound and outbound, with status and duration.
Call the provider directly and settle x402 per request.
Quickstart · x402 flow
1 · Call without payment. The service replies 402
bash
curl -i https://x402.monid.ai/v1/run \ -H "Content-Type: application/json" \ -d '{"provider": "saperly", "endpoint": "/get-numbers/{id}", "input": {}}'Response
HTTP/1.1 402 Payment Required{ "x402Version": 2, "accepts": [{ "scheme": "exact", "network": "eip155:143", "asset": "USDC", "maxAmountRequired": "0" }] }2 · Sign the payment with your agent wallet and retry
bash
curl https://x402.monid.ai/v1/run \ -H "X-PAYMENT: <base64 payment payload signed by your EOA>" \ -H "Content-Type: application/json" \ -d '{"provider": "saperly", "endpoint": "/get-numbers/{id}", "input": {}}'Response
HTTP/1.1 200 OKAny EOA on Monad can pay. curl shown; language tabs land in v2.
Any APIs or tools listed are provided for discovery purposes only and do not constitute an endorsement or recommendation by the Monad Foundation.
