Overview
Partner API (B2B)
A server-to-server API for B2B resellers and partners with a partner portal account to read the esimoa product catalog.
Who it is for#
The Partner API is for B2B resellers, travel agencies and corporate partners that have a contract with esimoa and a partner portal account. Your servers can read the same product catalog esimoa sells and build your own sales or support tools on top of it.
Prices (priceKRW) are esimoa retail prices in KRW. Supplier and cost information is never included in responses.
Tip
Running a blog, comparison site or AI product? The Public API is open to everyone and earns you a commission.
Getting access#
- 1Partnership inquiry — contact us first. esimoa reviews the request and creates the account for you.
- 2The account owner (OWNER) receives an invitation email. The link works once within 72 hours; set a password and you are signed in.
- 3Partner portal → API keys: issue your first key.
Base URL#
url
https://api.esimoa.com/b2b/v1Warning
Use this API from your backend. CORS does not allow browser calls from external sites. Never ship the key in frontend or app code.
Endpoints#
| Endpoint | Description |
|---|---|
| GET /b2b/v1/products | Search products |
| GET /b2b/v1/products/:id | One product |
| GET /b2b/v1/countries | Countries with products |
Every endpoint requires the catalog:read scope on the key (granted by default).
Response envelope#
On success the result is in data, and lists also include total, page and limit. Errors carry a code — the message is English and may change, so branch on code.
json
// Success
{ "success": true, "data": ..., "total": 128, "page": 1, "limit": 20 }
// Error
{ "statusCode": 401, "code": "INVALID_API_KEY", "message": "The API key is invalid." }Compared to the Public API#
| Partner API (B2B) | Public API (/v1) | |
|---|---|---|
| Keys from | Partner portal | Developer Center dashboard |
| Pagination | page (1~) · limit ≤ 50 | offset · limit ≤ 50 |
| Price field | priceKRW | priceKrw |
| Purchase link | None — sales follow your contract | url (with partner code) |
| Supplier info | Not included | provider |
| Rate limit | 300/min per key (adjustable per account) | 600/min per partner |