x402phone

AI phone calls and phone numbers. No API keys. No accounts. Pay per request.

Powered by x402 protocol and Bland.ai

How it works

  1. 1POST a phone number and task to /api/x402/call
  2. 2Get back a 402 with payment requirements (USDC on Base)
  3. 3Pay and resend — AI calls the number with your instructions
  4. 4Poll the status endpoint for transcript and summary

Example

POST /api/x402/call
{
  "phone_number": "+14155551234",
  "task": "Call and ask if they can meet tomorrow at 2pm. Be friendly and professional."
}
First response (pay this)
HTTP/1.1 402 Payment Required
X-PAYMENT: { "scheme": "exact", "network": "eip155:8453", ... }
After payment
{
  "success": true,
  "call_id": "abc-123-def",
  "message": "Call initiated successfully"
}

Endpoints

EndpointPrice
POST /api/x402/call

Make an AI phone call

$0.54
GET /api/x402/call/:id

Get call status and transcript

Free
POST /api/x402/number

Buy a phone number (30 days)

$20.00
POST /api/x402/number/topup

Extend a number 30 days

$15.00
GET /api/x402/numbers?wallet=0x...

List your phone numbers

Free

Voices

VoiceDescription
natdefaultAmerican female
joshArticulate American male
mayaYoung American female, soft
juneAmerican female
paigeCalm, soft-tone female
derekSoft and engaging male
florianGerman male

Pass any Bland.ai voice ID for custom voices.

Discovery

x402 resource discovery at /.well-known/x402

Agent instructions at /llms.txt