List countries

GET/v1/catalog/countriescatalog:read

Returns every country we recognise. Use it to build a destination picker and to turn the ISO codes in packages[].countries into names you can display.

This is reference data — it changes very rarely. Fetch it once and cache it.

curl https://partner-api.esimfo.com/v1/catalog/countries \
  -H 'Authorization: Bearer esf_live_at_...'

Response 200

This endpoint returns a bare array

Unlike the other list endpoints, the response is a plain JSON array with no data wrapper and no pagination — the full list arrives in one call. This is a published shape and will not change within /v1.

Field	Type	Notes
iso2	string	ISO 3166-1 alpha-2. This is the code the catalog uses
iso3	string	ISO 3166-1 alpha-3
name	string	English name
flag_emoji	string | null	Flag emoji, or null where none exists

[
  { "iso2": "TR", "iso3": "TUR", "name": "Turkey", "flag_emoji": "🇹🇷" },
  { "iso2": "DE", "iso3": "DEU", "name": "Germany", "flag_emoji": "🇩🇪" },
  { "iso2": "US", "iso3": "USA", "name": "United States", "flag_emoji": "🇺🇸" }
]

Notes

Match on iso2. That is the code used by packages[].countries and by the country filter on List packages. iso3 is there for systems that need it.

A country in this list is not a country you can sell. It is reference data, not availability. To find out what you can actually sell somewhere, call List packages with ?country=XX.

Errors

Status	Code	Cause
403	insufficient_scope	Key lacks catalog:read