One-time activation · REST + MCP

One number, one code

Buy a private number, catch the verification code, move on. The activation lives about 20 minutes — and if no code ever lands, by SMS or by call, you keep your money: prepaid balance is credited back and an unsettled x402 hold is released.

Lifetime
About 20 minutes
What you get
One verification code — by SMS, flash call or voice
Best for
Account verification and OTP flows
800+ services covered
200+ countries in stock
No signup to browse prices
Per number never a subscription

Start building

Get your API key in under a minute

Sign up with an email address — no card, no sales call. The sign-in link brings you straight back to this page and hands you a key that works with both the REST API and the MCP server.

Free to create. You pay per number, never a subscription.

How it works

Four steps, start to finish

Every step below maps to real endpoints and real tools. Hold on to the id a purchase gives you — everything after the buy hangs off it.

  1. 1

    Discover live inventory

    List services, then countries. Availability and exact USD prices are returned live.

    GET /v1/sms/activation/servicesGET /v1/sms/activation/countries sms_activation_list_servicessms_activation_list_countries
  2. 2

    Buy one number

    Pay from prepaid balance (REST also takes accountless x402), then keep the returned activation id.

    POST /v1/sms/activation/numbers sms_activation_buy_number
  3. 3

    Poll for the code

    Read status every few seconds until a code arrives or the activation is done.

    GET /v1/sms/activation/numbers/{id} sms_activation_get_code
  4. 4

    Complete or refund

    Use the code immediately. If no code (SMS or call) arrives before expiry, the activation is refunded automatically.

Set up once

Put Voxisim inside your AI client

Connect the hosted endpoint and your agent can price options, buy a number, and hand you the code without you writing a request. Nothing to install: there is no package, no local server, and no container — just one URL and a browser sign-in.

Hosted endpoint https://api.voxisim.com/mcp
Streamable HTTP · OAuth or bearer key
  1. 01

    Add the endpoint

    Choose your client below and copy the block it needs.

  2. 02

    Sign in once

    Approve the browser OAuth prompt, or pass a vxs_ key from your secret manager if you would rather not use OAuth.

  3. 03

    Just ask

    Your agent picks the right tools and carries ids between them, so a single sentence covers the whole lifecycle.

Claude

Web + Desktop

OAuth

Open Settings → Connectors, add a custom connector named Voxisim, then paste the hosted endpoint.

No config file
https://api.voxisim.com/mcp

Select Connect and finish the browser sign-in. Enable Voxisim from Search and tools in your chat.

Agent workflow

What your agent actually does

The tools are typed and named for the job, so results come back as structured fields rather than prose an agent has to re-read. Purchases are paid from your prepaid balance; top it up in your account or redeem a voucher.

5 tools for this product

  • sms_activation_list_services
  • sms_activation_list_countries
  • sms_activation_buy_number
  • sms_activation_get_code
  • sms_activation_list_numbers

Try asking your agent

Find the cheapest live country for WhatsApp, buy one activation, and wait for the verification code.
Show me the available countries and exact current prices for a Telegram activation before buying anything.
Check my active SMS activations and report any code that has arrived.
Buy a Telegram number that receives the code by voice call, and wait for it.

REST

REST quickstart

Discovery is public — run the first block right now with no account. Buying takes either a prepaid key or a signed x402 payment, and the request body is identical either way.

Two ways to pay, one purchase call

A prepaid balance is simpler when you buy often. Accountless x402 is better for a one-off autonomous purchase — save the receipt_token from the first paid response so you can read back what you bought.

1. Discover for free

No account is required. Fetch live availability and exact prices before purchase. SMS is the default; add verification_type=call or voice to the countries query to price a call method.

curl 'https://api.voxisim.com/v1/sms/activation/services'
curl 'https://api.voxisim.com/v1/sms/activation/countries?service_id=SERVICE_ID'
curl 'https://api.voxisim.com/v1/sms/activation/countries?service_id=SERVICE_ID&verification_type=call'

2A. Use prepaid balance

Create an account once, top it up over x402, then use the returned vxs_ key for purchases. For a call method, add "verification_type":"call" or "voice" to the purchase body.

curl -X POST https://api.voxisim.com/v1/signup \
  -H 'content-type: application/json' \
  -d '{"label":"docs-quickstart"}'

curl -X POST https://api.voxisim.com/v1/sms/activation/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"verification_type":"sms"}'

2B. Or pay accountlessly with x402

Send the purchase without credentials, sign one requirement from the 402 response, then retry the same request. verification_type goes in the body here too, and the 402 quotes that method's price.

curl -i -X POST https://api.voxisim.com/v1/sms/activation/numbers \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"verification_type":"sms"}'

curl -X POST https://api.voxisim.com/v1/sms/activation/numbers \
  -H 'content-type: application/json' \
  -H 'X-PAYMENT: BASE64_SIGNED_AUTHORIZATION' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"verification_type":"sms"}'

3. Poll for the code

Poll every few seconds until codes is non-empty or done is true. Each code carries a type (sms, call or voice); for a flash call, phone_from is the caller's number and its last digits are the code.

curl 'https://api.voxisim.com/v1/sms/activation/numbers/YOUR_ACTIVATION_ID' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
Method Route What it does
GET /v1/sms/activation/services List services and cheapest live options
GET /v1/sms/activation/countries List countries, stock, and exact prices
POST /v1/sms/activation/numbers Purchase a one-time number
GET /v1/sms/activation/numbers/{id} Read status and received codes
GET /v1/sms/activation/numbers List active or archived activations

Operating notes

Refunds, expiry, and recovering cleanly

Expiry and provider hiccups are normal states, not exceptions. Branch on the typed error, re-run discovery before you retry, and never assume last run's price still holds.

No code, no charge

If no code arrives before the roughly 20-minute expiry, whether by SMS or by call, the refund is automatic. Prepaid balance is credited back and an x402 authorization is released without ever settling — you do not have to ask.

One verification, then it is spent

Poll until codes is non-empty or done is true, then use the code promptly. An SMS activation catches a single code; a FlashCall activation may also catch an SMS, and a Voice activation an SMS, a flash call or a voice code — each tagged with its type. Start a new activation if you need another attempt.

Keep secrets out of prompts

vxs_ keys and x402 receipt_token values belong in a secret manager — not in prompts, source control, or logs.

When something goes wrong

  • invalid_argument — your service, country, or interval is stale. Re-run discovery and send a currently valid combination.
  • payment_required — expected on the x402 path. Sign one of the offered requirements and repeat the identical request.
  • number_unavailable or a conflict — that option just sold out. Discover again and pick another rather than replaying the same buy.
  • provider_unavailable or rate limiting — back off and honour the retry hint in the error. Retrying immediately makes it worse.

Not sure yet?

Activation and rental solve different problems

Pick the shortest lifetime that still covers your workflow. Stock and prices are live for both.

SMS Activation

You are here

Buy a one-time phone number and receive its verification code.

  • About 20 minutes
  • One verification code — by SMS, flash call or voice
  • Account verification and OTP flows

SMS Rental

Rent a phone number for a chosen duration and receive its SMS messages.

  • A day or more
  • Multiple SMS messages
  • Sessions, testing, and ongoing access
Read the SMS Rental guide

Where one-time activation fits

One-time passwordsAccount verificationSignup and QA automationShort agent-run tasks

FAQ

Activation questions

  • About 20 minutes from purchase. That window is for receiving the code, not for keeping the number — once it expires the number is gone and cannot be renewed.

  • You are refunded automatically at expiry. There is no support ticket and no claim to file: prepaid balance is credited back, and an x402 authorization that never settled is simply released.

  • Two ways to get the code by phone call instead of SMS, where the service texts the code to your number. With FlashCall the service calls and hangs up, and the caller's number is the code — usually its last digits; the service tells you how many. A FlashCall activation can also receive the code by SMS. With Voice (All-in-One) the service calls and a bot reads the code out, and the same activation can also catch the code by SMS or flash call. For either call method, choose "Call me" when the service asks how to send the code.

  • SMS, unless you have a reason not to. Switch to a call method when the service offers to call you instead, or when the SMS route for your country is sold out. Prices differ by method and country, so compare them before you buy. Voice catches SMS, flash calls and voice codes, so it is the safe pick when you are not sure how the service will send it.

  • Each method has its own stock, its own countries, and its own provider prices. A country can be cheap for FlashCall, dearer for SMS, and not offered for Voice at all. Pass verification_type to the countries endpoint to see current stock and exact prices for the method you want.

  • An SMS activation cannot — it is scoped to a single code. A FlashCall activation may also catch an SMS, and a Voice activation an SMS, a flash call or a voice code; each code is tagged with its type. If you need to verify again, buy another one — that is also why it is the cheapest option per code.

  • Usually within seconds of the service sending it, but that depends entirely on the service, not on us. Poll every few seconds rather than waiting on a single long request.

  • No. Call the countries endpoint right before you buy — it returns current stock and the exact price, and both move with real supply.

  • Yes. Send the purchase with no credentials, sign the x402 challenge that comes back, and repeat the request. Discovery never needed credentials in the first place.

Reference

The generated contracts

This page explains the workflow. For every parameter, response field, and tool input, go to the reference — it is generated from the live contract, so it cannot drift.

Ready to buy your first number?

Connect an MCP client and ask, or copy the REST quickstart and run it.