Query the full coverage list with pricing

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

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

Table 1: tyntec resource URLs to retrieve coverage and pricing.

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

Possible values

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.