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
| 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
}
