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.
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 --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
{
"error": "Missing iccid or slug"
}On this page