Guides

Last updated 2026-08-03

Short, practical walkthroughs. Each one is the shortest path to a working result.

Receiving your first code

1. Add funds. Open Wallet and create a deposit. Payment is in cryptocurrency; your balance updates once the network confirms it.
2. Choose the service. On Buy a number, pick the service you need a code for. Search if it is not among the popular tiles.
3. Choose the country. You will see live stock and the exact price for each. Cheapest is not always best — a country with deep stock is likelier to deliver.
4. Confirm. The number is issued straight away and the twenty-minute window starts.
5. Use it. Enter the number in the service you are registering with and request the code. It appears on the order screen by itself.

When a code does not arrive

First, check you entered the number in full, including the country dialling code, and that you actually pressed send code on the other service.

If it still has not arrived, you have three options:

• Wait. If you do nothing, the window closes and you are refunded in full, automatically.
• Cancel. Ends the order early and refunds you now, so you can try another country without waiting out the clock.
• Ban. Refunds you and makes sure that number is never issued to you again. Use this when the number is clearly burnt.

Choosing a country that works

Some services silently reject numbers from particular countries, and no reseller can change that. If a country fails twice for the same service, it is usually the service blocking that range rather than bad luck — switch country rather than retrying.

Stock is the most useful signal on the pricing page. A route with deep stock is being actively replenished; a route down to a handful of numbers often is not.

Using the API

The API mirrors the website exactly — same catalogue, same prices, same refund rules — so anything you can do by hand you can automate. Create a key in the API screen, then:

1. GET /api/v1/services to list what can be bought.
2. GET /api/v1/services/{service}/countries for prices and stock.
3. POST /api/v1/orders to buy a number.
4. Poll GET /api/v1/orders/{id} until the code appears, or the order expires and refunds itself.

Full details, including rate limits and error codes, are in the API reference.

Keeping costs down

• Cancel early rather than waiting out a window you already know has failed — it frees you to try a route that works.
• Compare countries on the pricing page before buying; the spread between the cheapest and dearest route for the same service is often several times over.
• Ban burnt numbers. It costs nothing and stops you paying twice for the same dead number.