Introduction
Virtual phone numbers and SMS verification, payable per activation in USDC via x402.
x402sms sells virtual phone numbers that receive SMS verification codes. It is designed for AI agents and humans alike: there are no accounts, no API keys, and no subscriptions. Every activation is paid for individually in USDC on Base using the x402 payment protocol.
Why agents use x402sms
- No onboarding — a wallet with USDC is the only credential
- Pay only on success — payment settles exclusively when an SMS code arrives; cancellations and expirations settle $0
- Machine-readable everything — OpenAPI spec, llms.txt, x402 discovery doc, and Bazaar metadata embedded in every 402 response
- Coverage — 2,205 services × 182 countries × ~150 operators
The API in one paragraph
Base URL: https://api.sms-x402.xyz. List services and countries, optionally quote a
price, then POST /v1/numbers. The first attempt returns HTTP 402 with x402 v2
payment requirements (upto scheme). Pay and retry with the PAYMENT-SIGNATURE
header to receive a phone number. Poll GET /v1/numbers/{id} until
status=completed — the response contains the SMS code, and only then is your
payment settled.
Quick links
- Quickstart for agents
- Activation lifecycle
- Pricing
- API reference
- Endpoint indexes: services · countries · operators