{"uid":"cap_hOLFtxssZxxOaiPhzHXq8","slug":"x402sms-virtual-number-activation-api-115cb9f6","name":"x402sms Virtual Number Activation API","description":"Virtual phone numbers and SMS verification for AI agents. Pay per activation in USDC via x402 on Base. You only pay when the SMS code arrives.","url":"https://api.sms-x402.xyz/v1/numbers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"type":"number","description":"Country api_id, e.g. 16 = United Kingdom. List: GET /v1/countries"},"service":{"type":"string","description":"Service alias to activate, e.g. 'tg' (Telegram), 'wa' (WhatsApp). List: GET /v1/services. Use 'ot' (Any other) if the target service is not listed."},"operator":{"type":"string","description":"Optional operator name. List: GET /v1/operators"}}},"responseSchema":{"type":"json","example":{"id":"3f8b2c1e-1234-4abc-9def-0123456789ab","number":"447412345678","status":"waiting_code","country":16,"service":"tg","expiresAt":"2026-01-01T00:25:00.000Z","accessToken":"ab12cd34...","priceAtomic":"1941139"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z1kKd3tFa6wH2P0-uyGbb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Provisions a virtual phone number for SMS verification of a specified service (e.g. Telegram, WhatsApp) in a given country, paid per activation in USDC via x402 on Base.","exampleAgentPrompt":"Get me a virtual UK phone number for Telegram verification — I'll pay in USDC on Base.","exampleUseCases":[{"title":"Telegram account signup automation","prompt":"I need to register a new Telegram account but don't want to use my real number — can you get me a virtual UK phone number for Telegram verification and pay for it with USDC?"},{"title":"WhatsApp bot onboarding","prompt":"Set up a new WhatsApp number for my bot in the United States — provision a virtual number for WhatsApp activation and charge it to my USDC wallet on Base."},{"title":"Any-service OTP for obscure platform","prompt":"I need to verify an account on a smaller platform that isn't listed — grab me a virtual German number using the 'other' service option and let me know when it's ready to receive the SMS code."}],"resultDescription":"Returns a JSON object containing a unique activation ID, the provisioned virtual phone number (e.g. 447412345678), current status ('waiting_code'), country and service identifiers, an expiry timestamp (~25 minutes), an access token for polling the code, and the price in atomic USDC units. The agent can use the access token to poll for the arriving SMS code.","failureModes":["No numbers available for the requested country/service/operator combination — returns an error with no number provisioned","Invalid country ID or service alias — returns a validation error","Payment failure via x402 — activation not created, no charge","Number expires before SMS code arrives — activation becomes invalid after ~25 minutes","Service alias not recognized — use 'ot' (Any other) as fallback"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to automate SMS-based account verification or OTP receipt for a specific service (Telegram, WhatsApp, etc.) in a specific country, and wants to pay programmatically in USDC on Base with no pre-funded account balance — you only pay when the SMS code is actually delivered. Prefer this over traditional SMS APIs when the agent operates in a crypto-native environment or needs pay-per-success billing rather than subscription or pre-paid credits.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-08-11T19:33:41.122Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T22:02:15.096Z","isFirstParty":false,"canonicalSlug":"x402sms-virtual-number-activation-api-115cb9f6"}