x402 SMS Verification API

Disposable phone numbers and SMS sending for AI agents

Not connected

SMS verification without KYC. Get a disposable phone number, receive an SMS code, or send SMS to any number.

Auto-paid via Lightning behind the scenes. You just pay USDC via x402.

Payment: USDC on Base or Solana | Protocol: x402

Heads up: These endpoints cost $3.00-$3.50 per call because each request purchases a real phone number and pays a Lightning invoice. Make sure you have enough USDC in your wallet.

Flow

POST /order with country + service → get orderId + number
Use the number on the target site to trigger the SMS verification
Poll GET /status/:orderId every 3-5 seconds until code appears
Number expires after 5 minutes if no code received

Endpoints

Order Number (Receive SMS)

POST /api/x402-sms/order

$3.00

Get a disposable phone number and receive an SMS verification code. Returns an orderId and phone number that you can use on any site.

country (number, optional) - Country code. Default: 187 (USA). See /services for available countries.

service (string, optional) - Service code for the target site. Default: "dp" (generic/any). See /services for available services.

Try it

Country

Service

Example Response

{
  "status": "ok",
  "orderId": "abc123",
  "number": "+12025551234",
  "pollUrl": "/status/abc123",
  "message": "Number assigned. Enter it on the target site, then poll /status/:orderId for the SMS code.",
  "expiresIn": "300 seconds"
}

Check SMS Status (Free)

GET /api/x402-sms/status/:orderId

FREE

Poll for the incoming SMS code. Rate limited: 1 request per 3 seconds, expires after 5 minutes.

Try it

Order ID

Send SMS

POST /api/x402-sms/send

$3.50

Send an SMS message to any phone number.

phone (string, required) - Phone number with country code, e.g. "+12025551234"

message (string, required) - Message text to send

Try it

Phone

Message

Free Endpoints

List Services

GET /api/x402-sms/services?country=187

FREE

List available SMS services for a country. Returns service codes you can use with /order.

Try it →

View Prices

GET /api/x402-sms/prices

FREE

Show x402 USDC prices and underlying sms4sats rates.

Try it →

x402 Protocol

How payment works:

POST to /order or /send without payment → get 402 Payment Required
Sign an EIP-3009 TransferWithAuthorization for the USDC amount (or Solana equivalent)
Base64-encode the payment and send it in the X-PAYMENT header
Your request is processed and the response returned

Networks: USDC on Base Mainnet (EVM) or Solana

Settlement: Gasless via ERC-3009 transferWithAuthorization