# Voxisim > Voxisim is an all-in-one privacy and connectivity ecosystem, spanning virtual phone numbers, eSIM, global IP telephony, and security tools. Its core active service is Receive SMS, which lets users receive SMS verification codes on both free public numbers and paid private numbers from a wide range of countries, for apps like WhatsApp, Instagram, Tinder, and Amazon. ## Brand - [Home](https://voxisim.com/): Brand landing page introducing Voxisim and its services. ## Receive SMS Temporary phone numbers for receiving SMS verification codes (OTP) from any app or website, in a wide range of countries. Two options are available: free public numbers (shared with other users, inbox history may be visible to others, best for low-risk one-off signups) and paid private numbers (not shared, for accounts where privacy or reliability matters more) via Android / iOS App, or via REST API or MCP API. - [Receive SMS - overview](https://voxisim.com/services/receive-sms): Main service page; latest public numbers grouped by country. - [US numbers](https://voxisim.com/services/receive-sms/us): Temporary US phone numbers. - [Verify - service directory](https://voxisim.com/services/receive-sms/verify): Full list of apps/services that can be verified using a public number. - [WhatsApp verification](https://voxisim.com/services/receive-sms/verify/whatsapp): Receive WhatsApp SMS codes on a public number. - [Instagram verification](https://voxisim.com/services/receive-sms/verify/instagram): Receive Instagram SMS codes on a public number. - [Tinder verification](https://voxisim.com/services/receive-sms/verify/tinder): Receive Tinder SMS codes on a public number. - [Amazon verification](https://voxisim.com/services/receive-sms/verify/amazon): Receive Amazon SMS codes on a public number. - [iOS app](https://apps.apple.com/us/app/get-sms-code-verify/id6476933273): Mobile app for Receive SMS; includes paid private numbers in addition to free public numbers. - [Android app](https://play.google.com/store/apps/details?id=app.getsmscode): Mobile app for Receive SMS; includes paid private numbers in addition to free public numbers. ## API - Start Here - [Full developer context](https://voxisim.com/llms-full.txt): Self-contained REST and MCP documentation. - [REST API reference](https://voxisim.com/docs/api.md): Endpoints, schemas, authentication, x402, and errors. - [OpenAPI contract](https://api.voxisim.com/openapi.json): OpenAPI 3.0 JSON for code generation and validation. - [MCP reference](https://voxisim.com/docs/mcp.md): Connection, authentication, protocols, and tool schemas. - [MCP endpoint](https://api.voxisim.com/mcp): Streamable HTTP JSON-RPC endpoint. ## API - Paying Everything is paid in USDC over x402 (the EIP-3009 `exact` scheme). Pick one of two modes: - **Pay per request** — no account, no signup. POST the purchase with no credentials, read the `402` response's `accepts` array, sign one entry, then repeat the identical request with `X-PAYMENT: `. The first payment mints an account keyed to your wallet and returns its API key once as `receipt_token` — persist it, or you lose the ability to read back what you bought. - **Prepaid balance** — pay once, spend many times. `POST https://api.voxisim.com/v1/signup` for a `vxs_` key, then `POST https://api.voxisim.com/v1/balance/topup")}` with `{"amount_usd": "5.00"}` through the same `402` → sign → retry loop. Afterwards, purchases sent with the bearer key debit that balance and need no per-request payment. Voucher codes issued by Voxisim are redeemed with `POST https://api.voxisim.com/v1/vouchers/claim`. Prices are live — read them from the discovery operations and never hardcode them. See [Paying for requests](https://voxisim.com/docs/api.md#paying) for the full challenge format and settlement semantics. ## SMS Activation Goal: Buy a one-time phone number and receive its verification code. Happy path: - REST: Fund first — either `POST /v1/signup` then `POST /v1/balance/topup` (prepaid balance, save the returned `vxs_` key), or skip signup entirely and pay per request with x402 → `GET /v1/sms/activation/services` to choose `service_id` → `GET /v1/sms/activation/countries` to choose `country_id` and current price → `POST /v1/sms/activation/numbers` with the bearer key (balance) or with `X-PAYMENT` after a `402` (x402) to buy, and save the returned `id` → poll `GET /v1/sms/activation/numbers/{id}` until a code arrives or the activation finishes. If no SMS arrives within 20 minutes the activation is auto-refunded — the x402 hold is released or the balance is credited back. - MCP: `POST /mcp/register` to create an account and save the returned `vxs_` key → initialize the MCP session with that bearer key → fund it with `topup_balance`, or leave the balance empty and pay per purchase with x402 → `sms_activation_list_services` to choose `service_id` → `sms_activation_list_countries` to choose `country_id` and current price → `sms_activation_buy_number` to buy (re-calling with a signed `payment` if it answers `payment_required`) and save the returned `id` → poll `sms_activation_get_code` until `codes` is non-empty or `done` is true. If no SMS arrives within 20 minutes the activation is auto-refunded — the x402 payment is released or the balance is credited back. - [REST endpoints](https://voxisim.com/docs/api.md#sms_activation): One-time numbers: a number that receives a single verification code and expires in ~20 minutes. - [MCP tools](https://voxisim.com/docs/mcp.md#sms_activation): Tool contracts for the same product. ## SMS Rental Goal: Rent a phone number for a chosen duration and receive its SMS messages. Happy path: - REST: Fund first — either `POST /v1/signup` then `POST /v1/balance/topup` (prepaid balance, save the returned `vxs_` key), or skip signup entirely and pay per request with x402 → `GET /v1/sms/rental/services` to choose `service_id` → `GET /v1/sms/rental/countries` to choose `country_id` → `GET /v1/sms/rental/intervals` to choose `hours` and current price → `POST /v1/sms/rental/numbers` with the bearer key (balance) or with `X-PAYMENT` after a `402` (x402) to rent, and save the returned `id` → poll `GET /v1/sms/rental/numbers/{id}/codes` for messages. - MCP: `POST /mcp/register` to create an account and save the returned `vxs_` key → initialize the MCP session with that bearer key → fund it with `topup_balance`, or leave the balance empty and pay per purchase with x402 → `sms_rental_list_services` to choose `service_id` → `sms_rental_list_countries` to choose `country_id` → `sms_rental_list_intervals` to choose `hours` and current price → `sms_rental_buy_number` to rent (re-calling with a signed `payment` if it answers `payment_required`) and save the returned `id` → poll `sms_rental_get_codes` for messages. - [REST endpoints](https://voxisim.com/docs/api.md#sms_rental): Rented numbers: a number rented for hours or days that receives many SMS over time. - [MCP tools](https://voxisim.com/docs/mcp.md#sms_rental): Tool contracts for the same product. ## Optional - [Privacy Policy](https://voxisim.com/privacy): How user and inbox data is handled. - [Terms of Service](https://voxisim.com/terms): Terms governing use of the public numbers and services.