Rates

The rate object

Look up pay-as-you-go retail rates for calling, messaging, and roaming data.

List PAYG retail rates for a market

Retrieves the pay-as-you-go retail price list for a market — international calling and messaging per destination, or roaming data per visited country.

Pass a market (an ISO 3166-1 alpha-2 country code — the home-plan market) and a rate type. The provider that prices the market is resolved internally, so the response is provider-agnostic: it carries only the country, the per-unit price, its unit, the currency and when it took effect. Prices are your organization's: any rate negotiated for it replaces the list price. They are in the provider's native currency; convert as needed.

Calling and messaging are priced from the country the subscriber is in. That is the market by default — a subscriber at home. Add servingCountry to price the same market's plan while roaming: market=DE&servingCountry=DK is a German plan used in Denmark, and the response echoes the servingCountry it priced from. ROAMING_DATA has no single serving country — it returns a per-MB price for every visited country — so it ignores the parameter and answers with servingCountry: null.

Calls and messages are priced outbound by default — what the subscriber pays to reach each destination. Add direction=inbound for the other leg: what the subscriber pays when someone in each country reaches them, which is chargeable while roaming. The response echoes the direction it priced; ROAMING_DATA has none and answers with direction: null.

Every country is listed, and a country that costs the subscriber nothing carries ratePerUnit: 0 rather than being left out. That covers both a route priced free — calls inside the EU/EEA, under roam-like-at-home — and one we publish no pay-as-you-go price for, such as a roaming-data country included in the plan. For calling and messaging the serving country itself is not listed, since a call that stays inside it is not an international one.

Prices are those in effect today. Add asOfDate (YYYY-MM-DD) to read the list for another day — for instance, a price change scheduled to take effect next month. The response echoes the asOfDate it priced. The provider is always the one serving the market today.

A market no provider serves answers 403 COUNTRY_NOT_SUPPORTED.

Scope: rates:read.

Requires the permission rates:read on the key.

Try it in the playground → Calls run against your live organization; there is no sandbox.

Parameters

Responses

Problems this endpoint can return

curl -X GET "https://api.telgea.com/v1/rates" \
  -H "x-api-key: $TELGEA_API_KEY"

{
  "market": "DE",
  "servingCountry": "DE",
  "direction": "outbound",
  "asOfDate": "2026-09-18",
  "rates": [
    {
      "country": "US",
      "ratePerUnit": 0.12,
      "unit": "minutes",
      "currency": "EUR",
      "validFrom": "2026-01-01"
    },
    {
      "country": "FR",
      "ratePerUnit": 0,
      "unit": "minutes",
      "currency": "EUR",
      "validFrom": null
    }
  ]
}