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

Parameter	Required	Type	Description
type	Yes	string	The type of service for which the rate is being requested. Possible values: sms, hlr, viber.
tariff	No	integr	Rate code in the Table of Rates
page	No	integer	Paginator page, minimum 1. The default is 1.
per_page	No	integer	The number of entries in the response. The default is 20.

Response parameters

Parameter	Type	Description
price	float	The 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.
currency	string	Personal user account currency. For all supported countries, the return code is ISO-4217.
mcc	integer	Mobile country code.
mnc	integer	Mobile network code.
country	string	The name of the country in which direction the price applies.
country code	string	Country 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
}