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
Inventory
API key or session
GET
List Topup Options
Retrieve available topup plans for an owned ICCID before placing a topup purchase.
Endpoint
GET /portal/topups
Endpoint behavior
This route loads available topup options for an owned ICCID. The server first verifies that the ICCID belongs to the authenticated reseller by scanning persisted order payloads, then calls the provider topup listing flow.
| Query parameter | Type | Required | Description |
|---|---|---|---|
| iccid | string | Yes | Owned ICCID to check for topup eligibility |
Topup availability
cURL
curl --location --request GET 'https://api.esimtrade.com/api/v1/portal/topups?iccid=8948010000095399804' \ --header 'x-access-code: YOUR_ACCESS_CODE' \ --header 'x-secret-key: YOUR_SECRET_KEY'
Live response shape when no topup list is available
JSON
{
"data": {
"error": "No packageList returned"
}
}On this page