Skip to content
eSIMTrade Docs
Public API
api.esimtrade.com
cURL
JavaScript
HTTP
JSON
Simpler, clearer reseller API docs.
Start with authentication, check wallet balance, read plans, and then move into orders and inventory. Each endpoint page includes its authentication mode, request fields, response shape, and copyable examples.
Fast scan
Live route coverage
Copyable examples
Getting Started
API key or session
Errors and Status Codes
Common HTTP responses returned by the reseller API routes and how to interpret them.
HTTP status guide
The eSIMTrade reseller API returns standard HTTP statuses rather than the numeric provider-style error code table used in some upstream systems. In practice, this gives integrations cleaner control flow and simpler retry policies.
| Status | Meaning | Typical cause |
|---|---|---|
| 400 | Bad Request | Missing required query or body field |
| 401 | Unauthorized | Missing, invalid, expired, or revoked credentials |
| 402 | Payment Required | Insufficient reseller wallet balance for purchase |
| 403 | Forbidden | Authenticated but not allowed for the action |
| 404 | Not Found | Owned ICCID or reseller-scoped record not found |
| 409 | Conflict | Duplicate or idempotent purchase collision |
| 429 | Too Many Requests | Per-key rate limit exceeded |
| 500 | Server Error | Unexpected internal or provider-facing failure |
Example error response
JSON
{
"error": "API rate limit exceeded"
}On this page