Choose a language

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
  1. The formula
  2. Volume tiers
  3. Reseller discount
  4. See your own prices
  5. Price protection
  6. Refunds

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

Text
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/prices returns your current price for every offer, your discount included, next to the list price.
  • GET /dev/v1/me shows your discount, where it comes from, your 30-day spend, your tier and how much is left until the next one:
Bash
curl -s https://smsgrab.com/api/dev/v1/me \
  -H "Authorization: Bearer $SMSGRAB_KEY"
JSON
{ "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?

Still need help?

Write to us. We answer every message, usually within a few hours.

Or email us at support@smsgrab.com