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. Each endpoint page includes its authentication mode, request fields, response shape, and copyable examples.
Query Order Status
Sync a provider order by order number or ICCID and update the persisted reseller order status.
Endpoint
GET /portal/orders
Endpoint behavior
This route syncs live provider status for an existing order by provider order number or ICCID. When an order number is supplied, the server also updates the local persisted PortalOrder status and records a provider_sync event.
If the synced status crosses into one of the notifiable lifecycle states, the server can also trigger reseller email updates once per status transition.
| Query parameter | Type | Required | Description |
|---|---|---|---|
| orderno | string | Either | Provider order number to sync |
| iccid | string | Either | ICCID to sync if order number is unavailable |
Sync by provider order number
curl --location --request GET 'https://api.esimtrade.com/api/v1/portal/orders?orderno=B26022703140001' \ --header 'x-access-code: YOUR_ACCESS_CODE' \ --header 'x-secret-key: YOUR_SECRET_KEY'
Sync by ICCID
curl --location --request GET 'https://api.esimtrade.com/api/v1/portal/orders?iccid=8948010000095399804' \ --header 'x-access-code: YOUR_ACCESS_CODE' \ --header 'x-secret-key: YOUR_SECRET_KEY'
Live response shape
{
"data": {
"esimTranNo": "26022703140001",
"orderNo": "B26022703140001",
"transactionId": "gs_1772162041486",
"imsi": "260010181623870",
"iccid": "8948010000095399804",
"qrCodeUrl": "https://p.qrsim.net/example.png",
"shortUrl": "https://p.qrsim.net/example",
"smdpStatus": "RELEASED",
"totalVolume": 524288000,
"totalDuration": 1,
"durationUnit": "DAY",
"orderUsage": 0,
"esimStatus": "CANCEL",
"packageList": [
{
"packageName": "Pakistan 500MB/Day",
"packageCode": "PUX79Y0PK",
"slug": "PK_0.5_Daily"
}
]
}
}On this page