Querying Membership Usage Orders and Details

Usage Order Status

Enum	Status	Description
1	Confirmed	The order has been confirmed and is ready to be used.
2	Used	The order has been used to access the service.
3	Cancelled	The order has been cancelled and cannot be used.
4	Expired	The order was not used before its validity period and has expired.
5	Pending	The order has been created and is awaiting confirmation. This may include waiting for availability checks, or third-party responses.
10	Failed	The order failed to be created or processed due to errors or unavailability.

Retrieve Order List

→ Use the /orders/memberships endpoint 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 the /orders/memberships/details endpoint 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 - Response

Lounge Walk-in Order Example

{
    "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
            },
            "resourceId": "N00001",
            "resourceName": "DragonPass Lounge",
            "iata": "MAN",
            "transportHubName": "Manchester Airport",
            "terminal": "Terminal 1",
            "city": "Manchester",
            "countryOrRegion": "GB",
            "passengerCounts": {
                "cardholder": 1,
                "guests": 1
            }
        }
    }
}

Lounge Prebooking Order Example

{
    "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
            },
            "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": "EK001"
            },
            "passengerCounts": {
                "cardholder": 1,
                "guests": 0
            }
        }
    }
}

Fast Track Prebooking Order Example

{
    "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
                }
            ]
        }
    }
}

Set Meal(Lounge Alternative) Order Example

{
    "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 Order Example

{
    "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"
            }
        }
    }
}

Querying Membership Usage Orders and Details