Partner API (B2B)

Countries

GET /b2b/v1/countries — list countries that have products on sale, with Korean or English names.

On this page

Request
Query parameters
Response

Request#

GET/b2b/v1/countries

curl "https://api.esimoa.com/b2b/v1/countries?lang=en" \
  -H "X-API-Key: $ESIMOA_PARTNER_KEY"

const res = await fetch('https://api.esimoa.com/b2b/v1/countries?lang=en', {
  headers: { 'X-API-Key': process.env.ESIMOA_PARTNER_KEY },
});
const { data: countries } = await res.json();

res = requests.get(
    "https://api.esimoa.com/b2b/v1/countries",
    params={"lang": "en"},
    headers={"X-API-Key": os.environ["ESIMOA_PARTNER_KEY"]},
    timeout=10,
)
countries = res.json()["data"]

Query parameters#

Parameter	Type	Description
`lang`	'ko' \| 'en'	Language of country names (default ko)

Response#

200 OKjson

{
  "success": true,
  "data": [
    { "countryCode": "AU", "name": "Australia", "planCount": 64 },
    { "countryCode": "JP", "name": "Japan", "planCount": 128 }
  ]
}

Field	Type	Description
`countryCode`	string	ISO 3166-1 alpha-2 country code
`name`	string	Country name (in lang)
`planCount`	integer?	Number of products on sale — omitted when unknown

The list is sorted by country name in the requested language. Countries without products and multi-country products are excluded — find multi-country products with isMultiCountry=true in product search.