Getting started
Introduction
Documentation for the REST APIs and MCP server that bring esimoa eSIMs to your website, app or AI assistant.
What you can build#
- eSIM search API — Search esimoa eSIMs by country, duration and data, and show them with live prices on your site or app.
- Tracking-link commission — Every purchase link in the API response carries your partner code. When a customer pays through it, you earn a commission.
- AI integrations (MCP) — Connect the esimoa MCP server to ChatGPT, Claude or Gemini and the AI can search, compare and link to eSIMs.
- Partner API (B2B) — Contracted B2B resellers and partners can pull the esimoa product catalog server-side to build their own storefronts.
Which API should I use?#
esimoa has two REST APIs with separate keys. For most websites, blogs and AI products the Public API is all you need.
| Public API (/v1) | Partner API (B2B) | |
|---|---|---|
| For | Affiliates — anyone with an esimoa account | Contracted B2B resellers and partners |
| Keys from | Developer Center dashboard | Partner portal |
| Key format | esk_live_<32> | esk_live_<10>_<40> |
| Base URL | https://api.esimoa.com/v1 | https://api.esimoa.com/b2b/v1 |
| How you earn | Commission on purchases through the tracking links in responses | Per your contract |
How it works#
- 1Sign in with your esimoa account, enter your site details and get a partner code instantly.
- 2Create an API key in the dashboard. The key is shown only once.
- 3Display products from the API along with their url (which carries your partner code).
- 4When a customer pays through the link, the commission is recorded in your dashboard.