What you can automate
- listing the available services and countries;
- ordering virtual numbers, with codes by SMS or by call;
- renting and extending numbers;
- checking statuses and reading SMS codes;
- webhooks or polling, whichever fits your process.
Built for retries
Every purchase carries an Idempotency-Key: a request repeated after a network error returns the same order instead of buying twice. Prices are shown before you buy, and the balance is the same as in the bot and the web account.
When you do not need the API
If you buy a number by hand once every few days, the Telegram bot is faster. The API pays off when there is a steady flow of orders.
How to start well
Try the flow in Telegram first, then move it into code. That makes statuses, cancellations and waiting for SMS easier to understand. The API key is issued in the bot or in the web account.
Frequently asked questions
When do I need an SMS Activation API?
When numbers are bought regularly from an app, a CRM, a script or an internal tool.
Can I receive SMS through a webhook?
Yes. The API automates order statuses and delivers SMS codes through webhooks or polling.
Should I start with the API right away?
If you have few orders, it is easier to start in the Telegram bot and move the flow to the API once it is proven.
The documentation lives separately: routes, statuses, errors and examples.
Open the documentation