DEVELOPERS

esimoa Developer Center

Bring esimoa eSIMs to your website, app or AI assistant. Show products with the search API or MCP server, and earn a commission on every purchase that comes through your tracking links.

Read the docs Become a partner

API documentation

Choose your API documentation for authentication, catalog queries, rate limits and errors.

IntroductionWhat you can build and which API to pick Public API (/v1)Search, detail and countries — with tracking links Partner API (B2B)Read the catalog with a partner portal key AI integrations (MCP)Connect ChatGPT, Claude and Gemini

Rate limits and errors

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.

How it works

1
Sign up as a partner
Sign in with your esimoa account, enter your site details and get a partner code instantly.
2
Create an API key
Create an API key in the dashboard. The key is shown only once.
3
Show search results
Display products from the API along with their url (which carries your partner code).
4
Earn on purchases
When a customer pays through the link, the commission is recorded in your dashboard.

Commission rules

Who can join: Anyone with an esimoa account — no approval, get an API key right after sign-up
Commission rate: 10% of the product amount the customer actually paid (after coupons/credits; USIM shipping fee excluded)
Attribution: Last click wins; tracking cookie lasts 30 days
Exclusions: Purchases made with the partner’s own account
Confirmation: Confirmed once 14 days have passed and the eSIM is activated (or after 90 days if never activated)
Refunds: Refunded orders cancel the commission
Payout: Commissions confirmed through the previous month are paid by bank transfer by the 15th · amounts under ₩10,000 carry over · payout details required · refunds after payout are deducted next month (contact support@esimoa.com)

Partner codes look like p_xxxxxxxx. Add ?ref=<code> to any esimoa page URL to turn it into a tracking link.

Get started today

Signing up is free and your partner code is issued instantly.

Dashboard AI integration guide

How it works

Sign up as a partner

Create an API key

Create an API key in the dashboard. The key is shown only once.

Show search results

Display products from the API along with their url (which carries your partner code).

Earn on purchases

When a customer pays through the link, the commission is recorded in your dashboard.

Commission rules

Who can join: Anyone with an esimoa account — no approval, get an API key right after sign-up
Commission rate: 10% of the product amount the customer actually paid (after coupons/credits; USIM shipping fee excluded)
Attribution: Last click wins; tracking cookie lasts 30 days
Exclusions: Purchases made with the partner’s own account
Confirmation: Confirmed once 14 days have passed and the eSIM is activated (or after 90 days if never activated)
Refunds: Refunded orders cancel the commission
Payout: Commissions confirmed through the previous month are paid by bank transfer by the 15th · amounts under ₩10,000 carry over · payout details required · refunds after payout are deducted next month (contact support@esimoa.com)

Partner codes look like p_xxxxxxxx. Add ?ref=<code> to any esimoa page URL to turn it into a tracking link.