Developer Docs

Table of contents

Get tariff

The BSG API allows you to get detailed information about the tariffs for sending SMS and Viber messages, as well as phone Number Verifier requests.

All rates are specified in the currency that is set in the account settings on the BSG platform.

The method provides prices for all countries to which SMS or Viber messages can be sent, as well as phone Number Verification requests.

To get tariffs, make a request to this URL:

GET http://one-api.bsg.world/api/accounts/tariff

Request parameters

ParameterRequiredTypeDescription 
typeYesstringThe type of service for which the rate is being requested. Possible values: sms, hlr, viber.
tariff NointegrRate code in the Table of Rates
pageNointegerPaginator page, minimum 1. The default is 1.
per_pageNointegerThe number of entries in the response. The default is 20.

Response parameters

ParameterTypeDescription 
pricefloatThe cost of sending one SMS message, if the sms service type was specified.The cost of sending one Viber message, if the viber type of service was specified. The cost of one phone number HLR verification request, if the hlr type of service was specified.
currencystringPersonal user account currency. For all supported countries, the return code is ISO-4217.
mccintegerMobile country code.
mncintegerMobile network code.
countrystringThe name of the country in which direction the price applies.
country codestringCountry code according to ISO-3166-1 alpha-2.

If the request is successful, you will receive a response:

{
  "data": [
    {
      "price": 0.46,
      "currency": "EUR",
      "mcc": 262,
      "mnc": 0,
      "country": "Germany",
      "country_code": "DE"
    }
  ],
  "total": 0
}

We use cookies (and other similar technologies) to collect data to improve your experience on our site. By using our website, you’re agreeing to the collection of data as described in our Website Data Collection Policy.