SMS API Pricing

Current prices for popular services

The table lists the most requested services and, for each one, the cheapest country that is on sale right now. The “cheapest” country is picked among countries with at least 20 numbers in stock; if none qualifies, among all countries in stock. The price of the country with the largest stock is shown next to it. Values are list prices: tier discounts apply automatically for eligible accounts. The table is cached and may lag by up to about 10 minutes; the binding price is the one returned by getPrices and getNumber (the quote is locked for 120 seconds).

Last updated: 2026-10-16 12:53 UTC. The table refreshes roughly every 10 minutes. Prices move with provider costs. For the exact, account-specific amount always rely on the getPrices response.

Charges are made in Turkish lira (TRY). USD and RUB figures are informational conversions; when a currency other than TRY is selected, the TRY amount is shown in brackets.

What you pay, and when

There are no subscriptions, monthly bundles or unused credits. Each activation is sold at its own price, which depends on the service (WhatsApp, Telegram, Google and so on) and the country of the number. Money moves in three steps:

Your balance must cover the price when you request a number, otherwise NO_BALANCE is returned. Reservations that are never settled are released automatically after about 20 minutes. You also need at least 5,00 ₺ on your account to request numbers.

Fetch prices programmatically

No need to copy prices by hand. Called with your API key, getPrices returns the price and stock for every service and country pair we can sell, as JSON shaped like {countryId: {serviceCode: {cost, count}}}. cost is the TRY amount that will leave your balance and count is the number of numbers in stock.

Request

curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getPrices&service=wa&country=41"

Response

{
    "41": {
        "wa": {
            "cost": 13,
            "count": 21920063
        }
    }
}

Narrow the response with service and country; to find the cheapest country, send only service. getCountries maps country ids to names and getNumbersStatus returns stock per service for one country. The API reference lists every endpoint.

Find the cheapest country

import requests

API = "https://turonay.com/stubs/handler_api.php"
prices = requests.get(API, params={
    "api_key": "YOUR_API_KEY",
    "action": "getPrices",
    "service": "wa",
}, timeout=15).json()

# prices -> {country_id: {"wa": {"cost": ..., "count": ...}}}
cheapest = min(
    ((cid, v["wa"]) for cid, v in prices.items() if v["wa"]["count"] >= 20),
    key=lambda item: item[1]["cost"],
    default=None,
)
print(cheapest)

The price you see is backed by a quote: the offer in a getPrices response is remembered for about two minutes. If, within that window, the recalculated price for the same service and country comes out higher (for instance after a switch to a backup provider), you are charged the quoted price.

Tier discounts

The more balance you have loaded in total, the higher the tier you reach, and each tier carries a fixed discount. It is applied automatically: no coupon or special agreement is needed. The top tier currently gives 10% off the list price.

The discount shows up in the getPrices response and in the actual charge in the same way: the cost you see with your own key is the amount deducted. Prices never go below a fixed floor, so the effect can be smaller on the cheapest services. The table on this page is shown without any discount.

Cap your spend with maxPrice

Add maxPrice to getNumber or getNumberV2 to set the highest amount you accept for one activation. The value is in TRY, the same unit as cost in getPrices.

curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=wa&country=41&maxPrice=13"
# ACCESS_NUMBER:<id>:<phone>   |   WRONG_MAX_PRICE:<price>

If the expected price is above your cap, WRONG_MAX_PRICE:<price> is returned before any number is taken, and nothing is deducted or held. If the price rises at purchase time because of a failover, the same check runs again: the number is cancelled and no reservation is opened.

Omitting the parameter, or sending 0, means no limit. A dot or a comma is accepted as the decimal separator (12.50, 12,50); ambiguous values such as 1,000.50 or 10 TRY are never silently accepted and are rejected with WRONG_MAX_PRICE.

Who are these prices for?

Developers who automate account verification, QA and test teams, resellers who sell numbers from their own panel, and anyone moving over from another service that uses the handler_api protocol get the most from per-activation pricing. See the SMS API for an overview, Resellers for reseller terms, and the Webhooks guide for code notifications by webhook.

Frequently asked questions

See your own prices

Call getPrices with your API key: list price, your tier discount and current stock come back in one response. Sign-up is free and you only pay for activations that receive a code.