Querying E-pass Usage Orders and Details

Overview

E-pass Order vs. Usage Order

In the DragonPass system, E-pass Orders and Usage Orders represent two different levels of an order lifecycle.

E-pass Order
An E-pass order usually starts with "MS".
It represents the purchase or issuance of an E-pass, which contains one or more available usages.

Usage Order
A Usage Order is generated each time an entitlement is actually used.
The order prefix varies by product type. For example, "SL" represents a single lounge usage.

Retrieve Order List

→ Use /orders/ePasses to retrieve the usage order list for a specific E-pass.

Request

Retrieve E-pass Order List - Request

{
  "ePassId": "8888000066668888",
  "module": 1,
  "pageSize": 10,
  "pageNumber": 1
}

Response

A successful response returns the list of all usage orders associated with the specified E-pass, including details of order created date, locations, and any relevant statuses.

Retrieve Order List - Response

The orderId in the response refers to the actual usage order's ID, not the E-pass order ID.

{
    "code": 0,
    "data": {
        "Pagination": {
            "pageSize": 10,
            "pageNumber": 1,
            "totalNumber": 3
        },
        "orders": [
            {
                "orderId": "DP00000000000001",
                "status": 2,
                "usedUsages": 1,
                "module": 1,
                "category": 1,
                "orderCreatedDate": "2024-12-31T00:00:00+00:00",
                "resourceId": "N00001",
                "resourceName": "DragonPass Lounge",
                "image": "https://image.dragonpass.com/uploadFile/images/cover.png",
                "transportHubName": "Manchester Airport",
                "transportHubId": "A00001",
                "city": "Manchester",
                "countryOrRegion": "GB"
            },
            {
                "orderId": "DP00000000000002",
                "status": 2,
                "usedUsages": 1,
                "module": 1,
                "category": 1,
                "orderCreatedDate": "2024-01-01T00:00:00+00:00",
                "resourceId": "N00002",
                "resourceName": "DragonPass Lounge",
                "image": "https://image.dragonpass.com/uploadFile/images/cover.png",
                "transportHubName": "Manchester Airport",
                "transportHubId": "A00001",
                "city": "Manchester",
                "countryOrRegion": "GB"
            }
        ]
    }
}

Retrieve E-pass Usage Order Details

→ Use /orders/epasses/details to retrieve the usage orders(walk-in/prebooking) associated with a specific E-pass, identifying when and where services linked to the E-pass have been used.

Request

Retrieve E-pass Usage Order Details - Request

{
    "orderId": "DP00000000000001"
}

Response

In our API response, the returned data consists of two parts:

Basic information

Order-specific information

Depending on the module and category of the order, the order-specific information will be included in the extra field.

Here is a example of a Lounge Walk-in order:

Retrieve E-pass Usage Order Details - Lounge Walk in - Response

Lounge Walk-in

{
    "code": 0,
    "data": {
        "status": 2,
        "module": 1,
        "category": 1,
        "ePassId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
            "usageDate": "2024-12-31T00:00:00",
            "usedUsages": 1,
            "resourceId": "N00001",
            "resourceName": "DragonPass Lounge",
            "iata": "MAN",
            "transportHubName": "Manchester Airport",
            "terminal": "Terminal 1",
            "city": "Manchester",
            "countryOrRegion": "GB"
        }
    }
}

Lounge Prebooking

{
    "code": 0,
    "data": {
        "status": 1,
        "module": 1,
        "category": 2,
        "ePassId": "1788000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": null,
            "usedUsages": 1,
            "resourceId": "N00001",
            "resourceName": "DragonPass Lounge",
            "iata": "MAN",
            "transportHubName": "Manchester Airport",
            "terminal": "Terminal 1",
            "city": "Manchester",
            "countryOrRegion": "GB",
            "vouchersList": [
                {
                    "voucher": "668800008888",
                    "voucherType": 1
                }
            ],
            "prebookingRequiredInfo": {
                "firstName": "DragonPass",
                "lastName": "DragonPass",
                "email": "developer@dragonpass.com",
                "phoneNumber": "8081966002",
                "callingCode": "44",
                "transportNumber": "EK0001"
            }
        }
    }
}

Fast Track Prebooking

{
    "code": 0,
    "data": {
        "status": 2,
        "module": 2,
        "category": 2,
        "ePassId": "1788000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": "",
            "usedUsages": 1,
            "resourceId": "C00001",
            "resourceName": "DragonPass Fast Track Service",
            "iata": "MAN",
            "transportHubName": "Manchester Airport",
            "terminal": "Terminal 1",
            "city": "Manchester",
            "countryOrRegion": "GB",
            "passengers": [
                {
                    "firstName": "DragonPass",
                    "lastName": "DragonPass",
                    "passengersType": 1,
                    "leadPassenger": true
                }
            ],
            "vouchersList": [
                {
                    "firstName": "DragonPass",
                    "lastName": "DragonPass",
                    "voucher": "668800008888",
                    "voucherType": 1
                }
            ],
            "prebookingRequiredInfo": {
                "firstName": "DragonPass",
                "lastName": "DragonPass",
                "email": "developer@dragonpass.com",
                "phoneNumber": "8081966002",
                "callingCode": "44",
                "transportNumber": "EK0001"
            }
        }
    }
}

Set Meal(Lounge Alternative)

{
    "code": 0,
    "data": {
        "status": 2,
        "module": 3,
        "category": 1,
        "ePassId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
            "usageDate": "2024-12-31T00:00:00",
            "usedUsages": 1,
            "resourceId": "R00001",
            "resourceName": "DragonPass Dining Restaurant",
            "iata": "MAN",
            "transportHubName": "Manchester Airport",
            "terminal": "Terminal 1",
            "city": "Manchester",
            "countryOrRegion": "GB"
        }
    }
}

Dining Coupon

{
    "code": 0,
    "data": {
        "status": 2,
        "module": 4,
        "category": 1,
        "ePassId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
            "usageDate": "2024-12-31T00:00:00",
            "usedUsages": 1,
            "resourceId": "R00001",
            "resourceName": "DragonPass Dining Restaurant",
            "iata": "MAN",
            "transportHubName": "Manchester Airport",
            "terminal": "Terminal 1",
            "city": "Manchester",
            "countryOrRegion": "GB",
            "diningOptions": {
                "description": "30.00 USD coupon to redeem against your total bill.",
                "value": "30",
                "currency": "USD"
            }
        }
    }
}

Fitness

{
    "code": 0,
    "data": {
        "status": 1,
        "module": 7,
        "category": 2,
        "ePassId": "1788000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": null,
            "usedUsages": 1,
            "resourceId": "F00001",
            "resourceName": "DragonPass Fitness Club",
            "city": "Manchester",
            "countryOrRegion": "GB",
            "vouchersList": [
                {
                    "voucher": "668800008888",
                    "voucherType": 1
                }
            ],
            "prebookingRequiredInfo": {
                "firstName": "DragonPass",
                "lastName": "DragonPass",
                "email": "developer@dragonpass.com",
                "phoneNumber": "8081966002",
                "callingCode": "44",
                "transportNumber": "string"
            },
            "fitnessOptions": {
                "optionId": "F00001-01",
                "optionName": "Day Pass",
                "optionType": 1,
                "startTime": "10:00",
                "endTime": "11:00",
                "description": "Book a day pass for gym access anytime during opening hours on your chosen date.",
                "highlights": [
                    "Full access to all gym facilities."
                ],
                "language": [
                    "English"
                ],
                "includes": [
                    "Bottle of water"
                ],
                "excludes": [
                    "Sportswear"
                ],
                "notes": [
                    "Please check-in at least 20 min before the class starts."
                ]
            }
        }
    }
}

eSIM

For eSIM orders, the usage details endpoint will only return basic order information. To retrieve additional details such as remaining data volume and expiration date, please use the Retrieve eSIM Order Extended Details endpoint.

{
    "code": 0,
    "data": {
        "status": 1,
        "module": 8,
        "category": 2,
        "ePassId": "1788000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": "2025-10-15T10:00:00",
            "usedUsages": 1,
            "resourceId": "E00001",
            "resourceName": "eSIM United Kingdom",
            "vouchersList": [
                {
                    "voucher": "668800008888",
                    "voucherType": 1
                }
            ],
            "esimOptions": {
                "optionId": "E00001-01",
                "optionName": "eSIM United Kingdom - 30GB 10Days",
                "status": 1,
                "activationDate": "2025-04-27T10:00:00+00:00",
                "expirationDate": "2025-04-27T10:00:00+00:00"
            },
            "esim": {
                "iccid": "898600F1234567890123",
                "status": 1
            },
            "esimOrderType": 1
        }
    }
}

Overview#

E-pass Order vs. Usage Order#

Retrieve Order List#

Retrieve E-pass Usage Order Details#

Lounge Walk-in#

Lounge Prebooking#

Fast Track Prebooking#

Set Meal(Lounge Alternative)#

Dining Coupon#

Fitness#

eSIM#

Overview

E-pass Order vs. Usage Order

Retrieve Order List

Retrieve E-pass Usage Order Details

Lounge Walk-in

Lounge Prebooking

Fast Track Prebooking

Set Meal(Lounge Alternative)

Dining Coupon

Fitness

eSIM