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. These docs are designed to help teams integrate faster with less scrolling and less guessing.

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 parameterTypeRequiredDescription
iccidstringYesOwned 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"
  }
}

Base URL

https://api.esimtrade.com/api/v1

Open on API host

On this page