Wholesale prices and volume tiers
The API sells at the same prices as the app, minus your wholesale discount: a volume tier based on your 30-day spend, or a fixed reseller discount.
On this page
The developer API sells every number at the same price as the app. Wholesale discounts then lower that price as your volume grows, and the same discount applies wherever you buy: in the app, on the website, in the Telegram bot and through the API.
The formula
price = ceil( list_price × (100 − discount_percent) / 100 )
price = max( price, minimum_price )
price = min( price, list_price )
list_price is what the number costs in the app. The result is rounded up to the next cent. A few very cheap numbers have a minimum price, so their discount can be smaller, and a price is never above the list price.
Volume tiers
Your discount follows your net spend (charges minus refunds) over the last 30 days, counted together on every channel. When your spend passes a tier, the discount applies within about 5 minutes to every number you buy, and you move back down when your 30-day spend falls below it. The current tiers are on the Wholesale page of the website and in GET /dev/v1/me.
Reseller discount
Approved resellers get a fixed discount on every number, whatever their monthly volume. You always get the larger of your reseller discount and your volume tier. Resellers can tag each purchase with customer_ref and read a statement per day, customer and service with GET /dev/v1/statement. You apply on the Wholesale page of the website, and the developer documentation explains the details.
See your own prices
GET /dev/v1/pricesreturns your current price for every offer, your discount included, next to the list price.GET /dev/v1/meshows your discount, where it comes from, your 30-day spend, your tier and how much is left until the next one:
curl -s https://smsgrab.com/api/dev/v1/me \
-H "Authorization: Bearer $SMSGRAB_KEY"
{ "pricing": {
"discount_percent": 5, "source": "tier", "program_enabled": true,
"trailing_30d_spend_minor": 31250,
"tier": { "level": 2, "min_spend_minor": 25000, "discount_percent": 5 },
"next_tier": { "level": 3, "min_spend_minor": 100000, "discount_percent": 8,
"remaining_minor": 68750 } } }
Price protection
The price is fixed the moment you buy and is stored with the activation. Send max_price_minor with every purchase: if the price has risen above it, the purchase is refused with 409 PRICE_CHANGED and nothing is charged.
Refunds
Purchases through the API follow the same rules as the app. A number without a code, or one you cancel before its first code, is refunded in full.
Was this article helpful?
Thanks! Glad it helped.