Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: esimoa Partner Countries API
version: 1.0.0
description: 'Search and compare travel eSIM plans sold by esimoa. Each result includes a purchase link with your partner code; you earn a commission on purchases made through it. Docs: https://www.esimoa.com/en/developers/docs'
servers:
- url: https://api.esimoa.com
security:
- ApiKeyAuth: []
tags:
- name: Countries
paths:
/v1/countries:
get:
operationId: listCountries
summary: Countries with eSIM plans on sale
parameters:
- name: q
in: query
schema:
type: string
description: Filter by name (any language) or ISO code
- name: lang
in: query
required: false
schema:
type: string
enum:
- ko
- en
- ja
- zh-CN
- zh-TW
- es
- fr
- ar
- vi
- th
- id
- it
- de
default: en
description: Language of country names and of the purchase page linked in `url`.
responses:
'200':
description: Countries
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
items:
type: array
items:
type: object
properties:
countryCode:
type: string
name:
type: string
planCount:
type: integer
lowestPriceKrw:
type:
- integer
- 'null'
url:
type: string
format: uri
tags:
- Countries
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key