Thumbnail
Pricing & Coverage API | Options | Query the full list

The coverage of tyntec’s services and the respective pricing can be queried in three ways:

tyntec resource URLs to retrieve coverage and pricing

Operation Resource URL Method
Query the full coverage /${baseURL}/coverage GET
Query the coverage for one country /${baseURL}/coverage?alpha3=${alpha3}
/${baseURL}/coverage?alpha2=${alpha2}
/${baseURL}/coverage?countryCode=${countryCode}
/${baseURL}/coverage?mcc=${mcc}
GET
Query the list of currently unavailable networks /${baseURL}/coverage/unavailable GET

To retrieve the full coverage and pricing list, make a GET request to the coverage resource using the credentials of the respective account. The following code blocks provide examples for SMS-MT:

Example of Query (JSON):

curl
-u username:password
-X GET
-H "Accept:application/json"
https://rest.tyntec.com/sms/v1/outbound/coverage

Response to Query Containing the Full Coverage and Price List (JSON):

HTTP/1.1 200 OK
{
      {
      "region":"Western Europe",
      "country":"Germany",
      "alpha3":"DEU",
      "alpha2":"DE",
"countryCode":49,
"ttid":15,
"operator":"Vodafone D2 GmbH",
"networkType":"GSM",
"available":true,
"classification":"unrestricted";
"mcc":"262",
"mnc":"02",
"accountSet":1,
"price":0.07,
"currency":"EUR",
"priceEffective":"2010-11-01T00:00:00+0000",
"comment":""
},}

Parameters and Descriptions in Reply:

Parameter Default Description
region UTF-8 encoded string The geographic region the country belongs to
country UTF-8 encoded string The respective name of the country
alpha3 Country code following ISO 3166-1 alpha-3 The three-letter country code.
alpha2 Country code following ISO 3166-1 alpha-2 The two-letter country code.
countryCode Country code according to ITU E.164 The international call prefix.
ttid integer The respective tyntec id of the target network.
operator UTF-8 encoded string The name of the operator.
networkType GSM/CDMA The technology used by the respective network.
available boolean The current availability of the network.
classification Unrestricted / restricted / P2P Allowed traffic type.
mcc Country code following ITU E.212 The mobile country code according to the ITU E.212 numbering standard.
mnc Network code following ITU E.212 The mobile network code according to the ITU E.212 numbering standard.
accountSet integer The pricing set used for the account.
price float The price per message for the respective network.
currency Currency code following ISO 4217 The currency in which the price is given; this corresponds to the currency of the invoice.
priceEffective Date in the format “yyyy-MM-ddTHH:mm:ss” (according to ISO 8601) The date when the “price” became effective.
comment UTF-8 encoded string Further information regarding the respective network.