Getting started
Quickstart
Join as a partner, create an API key and send your first eSIM search request.
Get an API key#
- 1Sign in with your esimoa account and join on the dashboard.
- 2Create a key in the API keys section. It is shown only once, so save it right away.
Make your first request#
Call the API like below to get 7-day Japan eSIMs sorted by price.
curl "https://api.esimoa.com/v1/esims?country=JP&days=7&sort=price&limit=3&lang=en" \
-H "X-API-Key: esk_live_your_key_here"const res = await fetch(
'https://api.esimoa.com/v1/esims?country=JP&days=7&sort=price&limit=3&lang=en',
{ headers: { 'X-API-Key': process.env.ESIMOA_API_KEY } },
);
if (!res.ok) throw new Error(`esimoa API ${res.status}`);
const { items, total } = await res.json();
for (const esim of items) {
console.log(esim.title, esim.priceKrw, esim.url);
}import os
import requests
res = requests.get(
"https://api.esimoa.com/v1/esims",
params={"country": "JP", "days": 7, "sort": "price", "limit": 3, "lang": "en"},
headers={"X-API-Key": os.environ["ESIMOA_API_KEY"]},
timeout=10,
)
res.raise_for_status()
for esim in res.json()["items"]:
print(esim["title"], esim["priceKrw"], esim["url"])Read the response#
The base URL is https://api.esimoa.com. All responses are JSON and prices are integer KRW.
Each item’s url carries your partner code. Show it as-is so purchases made through it earn you a commission.