API reference

Prices

What you pay per part, by country and network, and the changes we've announced.

GEThttps://api.siellabs.com/v1/prices

Query parameters#

countrystringOptional

Only this country's prices: an ISO 3166-1 alpha-2 code, such as GB.

The prices are your account's own, for the product your API key sends under, as the console's Billing page shows them. A message costs its price per part times its parts.

curl "https://api.siellabs.com/v1/prices?country=GB" \
  -H "Authorization: Bearer $SMSGW_API_KEY"

200 OK

{
  "currency": "EUR",
  "data": [
    {
      "country": "GB",
      "mccmnc": "",
      "price_micros": 30000,
      "effective_from": "2026-10-01T00:00:00Z",
      "state": "current"
    },
    {
      "country": "GB",
      "mccmnc": "23415",
      "network": "Vodafone UK",
      "price_micros": 32000,
      "effective_from": "2026-10-01T00:00:00Z",
      "state": "current"
    },
    {
      "country": "GB",
      "mccmnc": "23415",
      "network": "Vodafone UK",
      "price_micros": 31000,
      "effective_from": "2026-12-01T00:00:00Z",
      "state": "scheduled"
    }
  ]
}

Fields#

countrystring

ISO 3166-1 alpha-2. * is the price for every country not listed.

mccmncstring

The network's MCC and MNC. Empty for the price to the rest of the country: numbers on a network without its own price.

networkstring

Only for a network's price: its name.

price_microsinteger

The price per part in micros: 30000 is 0.03.

pricingstring

Only where a country has a local and an international price: local or international, whichever applies to your account. Traffic is local where we registered your business.

effective_fromstring

When the price applies from.

statestring

current, or scheduled for a change we've announced, from effective_from.

A country or network that isn't listed isn't enabled for your account: sending there is refused with destination_not_enabled.