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
POST
Create Topup
Place a topup against an owned ICCID using a valid topup slug returned from the availability query.
Endpoint
POST /portal/topups
Endpoint behavior
This route places a provider topup request after verifying ownership of the ICCID. Use the slug returned from the topup availability route rather than inventing a topup slug manually.
| Body field | Type | Required | Description |
|---|---|---|---|
| iccid | string | Yes | Owned ICCID |
| slug | string | Yes | Topup slug from the topup availability result |
| qty | number | No | Optional quantity, defaults to 1 |
Create topup
cURL
curl --location --request POST 'https://api.esimtrade.com/api/v1/portal/topups' \
--header 'x-access-code: YOUR_ACCESS_CODE' \
--header 'x-secret-key: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
"iccid": "8944501234567890123",
"slug": "japan-topup-3gb",
"qty": 1
}'Validation error example
JSON
{
"error": "Missing iccid or slug"
}On this page