Check eSIM Top-up Availability

POST

https://developer-sandbox.dragonpass.com/api/v2/orders/esims/topup/availability

Last modified:2025-12-25 07:55:04

This API allows corporate clients to verify whether a specific eSIM (identified by ICCID) supports top-up for a certain data plan and returns a prebooking token if available.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Example

{
    "ePassId": "1788000066668888",
    "module": 8,
    "resourceId": "E00001",
    "optionId":"E00001-01",
    "prebookingDate": "2025-10-01T10:30",
    "iccid": "898600F1234567890123",
    "adultCount": 1,
    "childCount": 0
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://developer-sandbox.dragonpass.com/api/v2/orders/esims/topup/availability' \
--header 'X-Program-ID;' \
--header 'X-Request-ID;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ePassId": "1788000066668888",
    "module": 8,
    "resourceId": "E00001",
    "optionId":"E00001-01",
    "prebookingDate": "2025-10-01T10:30",
    "iccid": "898600F1234567890123",
    "adultCount": 1,
    "childCount": 0
}'

Responses

🟢200成功

application/json

Body

Examples

SuccessException

{
    "code": 0,
    "data": {
        "available": true,
        "prebookingToken": "85c69b8e790befc7e94870ec269c3f1d",
        "validUntil": 1923263999,
        "price": null
    }
}

Modified at 2025-12-25 07:55:04

Retrieve eSIM Order Live Extended Details

Retrieve eSIM Data Packages