eSIMTrade Docs
api.esimtrade.com
Simpler, clearer reseller API docs.
Start with authentication, check wallet balance, read plans, and then move into orders and inventory. These docs are designed to help teams integrate faster with less scrolling and less guessing.
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
{
"error": "API rate limit exceeded"
}On this page