Querying Membership Usage Orders and Details

Overview

Retrieve Order List

→ Use /orders/memberships to retrieve the order list for a specific membership or a particular user.

Request

Retrieve Membership Order List - Request

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

Response

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

Retrieve Membership Order List - Response

The orderId will be included in the response, which can be used to further search for order details via /orders/memberships/details.

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

Retrieve Order Details

→ Use /orders/memberships/details to retrieve the order details.

Request

Retrieve Membership 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 sample of a lounge Walk-in order:

Retrieve Membership Usage Order Details - Lounge - Response

Lounge Walk-in

{
    "code": 0,
    "data": {
        "status": 2,
        "module": 1,
        "category": 1,
        "membershipId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "usageDate": "2024-12-31T00:00:00",
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 1,
                "sharedEntitlements": 0
            },
            "passengerCounts": {
                "cardholder": 1,
                "guests": 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,
        "membershipId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": "2025-10-01T10:35:26+00:00",
            "cashPaymentApplied": false,
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 0,
                "sharedEntitlements": 0
            },
            "passengerCounts": {
                "cardholder": 1,
                "guests": 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",
                "flightNumber": "EK0001"
            }
        }
    }
}

Fast Track Prebooking

{
    "code": 0,
    "data": {
        "status": 2,
        "module": 2,
        "category": 2,
        "membershipId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": null,
            "cashPaymentApplied": false,
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 0,
                "sharedEntitlements": 0
            },
            "passengerCounts": {
                "cardholder": 1,
                "guests": 0
            },
            "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",
                "flightNumber": "EK0001"
            }
        }
    }
}

Set Meal(Lounge Alternative)

{
    "code": 0,
    "data": {
        "status": 2,
        "module": 3,
        "category": 1,
        "membershipId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "usageDate": "2024-12-31T00:00:00",
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 1,
                "sharedEntitlements": 0
            },
            "passengerCounts": {
                "cardholder": 1,
                "guests": 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,
        "membershipId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "usageDate": "2024-12-31T00:00:00",
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 0,
                "sharedEntitlements": 0
            },
            "passengerCounts": {
                "cardholder": 1,
                "guests": 0
            },
            "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,
        "membershipId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": null,
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 0,
                "sharedEntitlements": 0
            },
            "cashPaymentApplied": false,
            "passengerCounts": {
                "cardholder": 1,
                "guests": 0
            },
            "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": "EK001"
            },
            "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,
"membershipId": "8888000066668888",
"orderId": "DP00000000000001",
"orderCreatedDate": "2024-12-31T00:00:00+00:00",
"orderCancelledDate": null,
"extra": {
"prebookingDate": "2025-10-01T10:30",
"usageDate": null,
"usedEntitlementDetails": {
"cardholderExclusiveEntitlements": 0,
"guestsExclusiveEntitlements": 0,
"sharedEntitlements": 1
},
"resourceId": "E00001",
"resourceName": "eSIM United Kingdom",
"vouchersList": [
{
"voucher": "668800008888",
"voucherType": 1
}
],
"esimOptions": {
"optionId": "E00001-01",
"optionName": "eSIM United Kingdom - 30GB 10Days"
},
"esimOrderType": 1
}
}
}

Overview#

Retrieve Order List#

Retrieve Order Details#

Lounge Walk-in#

Lounge Prebooking#

Fast Track Prebooking#

Set Meal(Lounge Alternative)#

Dining Coupon#

Fitness#

eSIM#

Overview

Retrieve Order List

Retrieve Order Details

Lounge Walk-in

Lounge Prebooking

Fast Track Prebooking

Set Meal(Lounge Alternative)

Dining Coupon

Fitness

eSIM