Tizondocs
ReferenceOffers

List countries

GET
/v1/countries

Every country with an offer this key's mode can buy, A to Z, with how many offers it has. Build a country picker from it, then fetch a country's offers with GET /v1/offers?country=. Not paged: there are at most a few hundred.

A regional or global bundle covers no single country, so it counts towards none here. It is still listed by GET /v1/offers, with coverage: null.

Authorization

ApiKey
AuthorizationBearer <token>

An account API key, sent as Authorization: Bearer tz_live_…. The prefix selects the mode: tz_test_ for sandbox, tz_live_ for real money.

In: header

Query Parameters

category?string

Count only offers in this category.

Value in

  • "esim"
  • "mobile_topup"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/countries"
{  "object": "list",  "data": [    {      "country": "JP",      "offer_count": 12    }  ]}