ReferenceOffers
List 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 } ]}