Resell Virtual Numbers With Our API: Prices and Margin

Resell private virtual numbers with the SMS Activate App API: buy at our price on your account, add your margin, and serve clients from your bot or site.

This guide is for you if you want to offer private virtual numbers to your own clients through a white-label service, a Telegram bot or a small site. It covers how the setup works, how to price each number, the API calls you need, how billing works and where our responsibility ends.

How reselling works

You hold one account with SMS Activate App and an API key. You buy numbers on that account through the API. Your bot or site then shows each client their number and the SMS verification codes that arrive on it.

Each number is a real mobile or local number from a carrier's range, depending on the country. Your account holds it for a 28-day term. It receives SMS and calls.

Your clients are your clients. You take their payments, answer their questions and set your own terms. They do not need an account with us. More on this model on the reseller page.

Set your price and margin

Our price is set per number and per country. You read it live from the API:

  • GET /v1/public/countries returns each country's minPriceCents, maxPriceCents and availableNumbers.
  • GET /v1/public/numbers/search?country=US&limit=20 returns live numbers for sale. The priceCents field of each one is your price.

All money in the API is in integer USD cents.

Your price is our price for that number plus your margin. If a number costs you C and you sell it at P, your margin is P minus C. Your margin percentage is (P minus C) divided by P. Markup is a different figure: (P minus C) divided by C. Markup is always the larger of the two, so decide which one you mean before you set a target.

Recalculate from the live price at each sale. Do not work from a fixed list, because prices can change by country. There is no reseller discount or volume tier: you buy at the normal price, the same one shown on pricing.

Budget for these costs as well:

  • Final purchases. A number is final and non-refundable once issued, even if a platform rejects it.
  • Platform decisions. The platform, not us, decides whether it accepts a number. Let your clients check that a number works for their service first, or build that risk into your price.
  • Auto-renew. A number renews and bills every 28 days unless you turn auto-renew off.
  • Payment fees. Your own payment processor charges you for each client payment.
  • Support time. Your clients will ask you questions, and answering them takes your time.

The API flow, step by step

The base URL is https://api.sms-activate.app/v1/public. Every call, the catalog included, needs your key in the header Authorization: Bearer vpn_xxx.

  • List countries. Call GET /countries to see which countries have numbers and their price range.
  • Find numbers. Call GET /numbers/search?country=US&limit=20 to list live numbers for a country, each with your price in priceCents.
  • Buy a number. Call POST /numbers with a JSON body {"phone": "+15551234567", "country": "US"} and an Idempotency-Key header set to a UUID. Send the same key again on a retry and you are not charged twice. A successful purchase returns 201 with the number, chargedCents and balanceAfterCents. Two fields are optional: autoRenew (default true) and note. Use note to store your client's reference.
  • Read codes. Call GET /numbers/{id}/sms for one number, or GET /sms for all your numbers. Both are cursor-paginated. To have codes pushed instead, call PATCH /numbers/{id} with {"forwardWebhookUrl": "https://your-app.example.com/sms"}: every SMS and call on that number is then posted to your server, signed with HMAC-SHA256. Match each code to the right client before you show it.
  • Manage the term. If a client does not renew, call PATCH /numbers/{id} with {"autoRenew": false}. To release a number you no longer need, call DELETE /numbers/{id}.

Two more calls help with accounting. GET /balance returns your balance in cents. GET /v1/me/transactions lists your statement.

Errors come in one shape: {"error": "<code>", "message": "...", "reqId": "..."}. Branch on the error code, not the HTTP status. Some refusals, such as insufficientbalance, nonumbers and priceexceeded, are answers. Show them to your client instead of retrying blindly. On ratelimited, wait as long as the Retry-After header says.

The full spec is the OpenAPI file, and the API docs explain each call.

Billing: your balance with us

Your purchases are paid from your account balance. On the website you top up in crypto (USDT). The Telegram bot also accepts a ruble bank card and Telegram Stars. Once you link your account, both use one balance.

Keep enough balance before your busy hours. A purchase made with too little balance is refused with insufficient_balance, and your client waits while you top up.

Withdrawals are paid only in USDT (TRON, BSC or TON). You withdraw yourself in your account on the site or in the Telegram bot: up to $100 a day is paid automatically within minutes, and support pays a larger amount by hand on request. Money paid by card, granted as a bonus or received as a transfer can be withdrawn 180 days after it was credited; crypto top-ups right away. The minimum is $10. The fee is 10% of the amount, but not less than 5 USDT, taken from the amount.

Your own purchases and the partner program

Purchases on your own account, or on any account you control, never earn partner commission.

Some clients will prefer an account of their own. Send them your partner link. You then earn 10% to 30% of our margin (not of the price) on their purchases and renewals for as long as their account exists; the share rises with how many of the people you brought have bought, from 10% for the first 3 buyers to 30% from buyer 3001 on. Each commission is credited to your balance 30 days after the purchase. Details on the affiliate program and reseller pages.

Support

Your clients contact you. You contact us. A person answers by email at support@sms-activate.app or in Telegram at t.me/BestVoipTelegram, usually within 24 hours.

Do not promise your clients more than we promise you. We do not promise that every code arrives, and we do not promise that a platform accepts a number. Most codes arrive within a few minutes of the platform sending them. Tell your clients to test a number for their service before they rely on it.

Useful videos

Third-party videos on pricing, Telegram bots and API design. They teach general techniques and do not cover our service.

Start

  • Create a free account on the registration page.
  • Create an API key in the account dashboard, on the API keys tab.
  • Read the API docs and the OpenAPI file.
  • Check live prices on pricing.
  • Buy one number and test your flow end to end before you open sales.