Search for Resources

Overview

DragonPass resource search-related APIs primarily consist of the following 3 parts:

Basic Search Functions
Fundamental search capabilities that enable querying of resources based on general criteria.

Search for Available Options under Resources
This feature allows clients to search for available options associated with resources. It is applicable only to specific modules.

Check Prebooking Availability for Certain Resources or Options
This feature enables verification of the prebooking availability status of certain resources or options. It is applicable only to resources that require prebooking.

List Transport Hubs

→ Use /transportHubs to retrieve the list of transport hubs that offer at least one DragonPass resource for your program.

Response

Retrieve Transport Hub - Response

{
    "code": 0,
    "data": {
        "pagination": {
            "pageSize": 10,
            "pageNumber": 1,
            "totalNumber": 1
        },
        "language": "en-US",
        "transportHubs": [
            {
                "transportHubId": "A00001",
                "transportHubName": "Manchester Airport",
                "type": 1,
                "iata": "MAN",
                "city": "Manchester",
                "countryOrRegion": "GB",
                "continent": "Europe",
                "latitude": "53.467",
                "longitude": "-2.233"
            }
        ]
    }
}

Retrieve Transport Hub Details

→ Use /transportHubs/{transportHubId} to retrieve further details of a specific transport hub if needed.

Response

Retrieve Transport Hub Details - Response

{
    "code": 0,
    "data": {
        "language": "en-US",
        "transportHubId": "A00001",
        "transportHubName": "Manchester Airport",
        "iata": "MAN",
        "type": 1,
        "city": "Manchester",
        "countryOrRegion": "GB",
        "continent": "Europe",
        "latitude": "53.467",
        "longitude": "-2.233",
        "imagesList": [
            {
                "url": "https://image.dragonpass.com/uploadFile/images/test1.png",
                "order": 1
            },
            {
                "url": "https://image.dragonpass.com/uploadFile/images/test2.png",
                "order": 2
            },
            {
                "url": "https://image.dragonpass.com/uploadFile/images/test3.png",
                "order": 3
            }
        ]
    }
}

Retrieve Resources List

→ Use /resources to retrieves a list of available resources based on query parameters. It currently supports two types of filters:

Filter resources by module. When used alone, this returns all resources within the specified module.

Filter resources by a specific transport hub (using transportHubId). When combined with a module filter, only resources belonging to that module at the specified transport hub will be returned. Please note that only a single module value is supported when used together with transportHubId.

Response

Retrieve Resource List - Response

{
    "code": 0,
    "data": {
        "pagination": {
            "pageSize": 10,
            "pageNumber": 1,
            "totalNumber": 3
        },
        "language": "en-US",
        "resources": {
            "transportHubResources": [
                {
                    "module": 1,
                    "resourceId": "N00001",
                    "resourceName": "DragonPass Lounge",
                    "locationInfo": {
                        "city": "Manchester",
                        "countryOrRegion": "GB",
                        "continent": "Europe",
                        "transportHubId": "A00001",
                        "transportHubName": "Manchester Airport",
                        "iata": "MAN",
                        "location": "Airside - After security check and passport control",
                        "timezone": "Europe/London"
                    },
                    "image": "https://image.dragonpass.com/uploadFile/images/cover.png",
                    "extra": {
                        "loungeInfo": {
                            "area": 1,
                            "routeTypes": [
                                1
                            ],
                            "terminal": "Terminal 1",
                            "nearestGate": "A1",
                            "tier": 1
                        }
                    }
                },
                {
                    "module": 2,
                    "resourceId": "C00001",
                    "resourceName": "DragonPass FastTrack Service",
                    "locationInfo": {
                        "city": "Manchester",
                        "countryOrRegion": "GB",
                        "continent": "Europe",
                        "transportHubId": "A00001",
                        "transportHubName": "Manchester Airport",
                        "iata": "MAN",
                        "location": "FastTrack is located at the entrance to Security",
                        "timezone": "Europe/London"
                    },
                    "image": "https://image.dragonpass.com/uploadFile/images/cover.png",
                    "extra": {
                        "fastTrackInfo": {
                            "routeTypes": [
                                1
                            ],
                            "terminal": "Terminal 1"
                        }
                    }
                },
                {
                    "module": 6,
                    "resourceId": "R00001",
                    "resourceName": "DragonPass Dining Restaurant",
                    "locationInfo": {
                        "city": "Manchester",
                        "countryOrRegion": "GB",
                        "continent": "Europe",
                        "transportHubId": "A00001",
                        "transportHubName": "Manchester Airport",
                        "iata": "MAN",
                        "location": "Airside - After security check and passport control",
                        "timezone": "Europe/London"
                    },
                    "image": "https://image.dragonpass.com/uploadFile/images/cover.png",
                    "extra": {
                        "diningInfo": {
                            "area": 1,
                            "routeTypes": [
                                1
                            ],
                            "terminal": "Terminal 1",
                            "nearestGate": "A1",
                            "diningOptions": [
                                {
                                    "module": 3,
                                    "optionName": "Set Meal",
                                    "description": "One set meal can be redeemed for each transaction.",
                                    "value": null,
                                    "currency": null
                                },
                                {
                                    "module": 4,
                                    "optionName": "30 USD Coupon",
                                    "description": "30.00 USD coupon to redeem against your total bill.",
                                    "value": 30,
                                    "currency": "USD"
                                }
                            ],
                            "tier": 1
                        }
                    }
                }
            ],
            "lifestyleResources": [
                {
                    "module": 7,
                    "resourceId": "F00001",
                    "resourceName": "DragonPass Fitness",
                    "locationInfo": {
                        "city": "Manchester",
                        "countryOrRegion": "GB",
                        "continent": "Europe",
                        "transportHubId": null,
                        "transportHubName": null,
                        "iata": "null",
                        "location": "Manchester M90 1QX",
                        "timezone": "Europe/London"
                    },
                    "image": "https://image.dragonpass.com/uploadFile/images/cover.png",
                    "extra": {
                        "fitnessInfo": null
                    }
                }
            ]
        }
    }
}

Retrieve Resource Details

→ Use /resources/{resourceId} to retrieve the resource details.

Response

Retrieve Resource Details - Response

extra object will provides additional information specific to certain resources, based on the requirements of different modules.

Only the relevant module-specific information will be included depending on the resource type being queried. For example, when querying a lounge resource, only loungeInfo will be returned within ext

Example:

Lounge

{
    "code": 0,
    "data": {
        "language": "en-US",
        "module": 1,
        "resourceId": "N00001",
        "resourceName": "DragonPass Lounge",
        "locationInfo": {
            "city": "Manchester",
            "countryOrRegion": "GB",
            "continent": "Europe",
            "transportHubId": "A00001",
            "transportHubName": "Manchester Airport",
            "iata": "MAN",
            "location": "Airside - After security check and passport control",
            "timezone": "Europe/London"
        },
        "businessHours": [
            {
                "day": 1,
                "times": {
                    "type": "STANDARD",
                    "detail": "00:00-23:59"
                }
            }
        ],
        "prebookingPolicy": {
            "isBookable": true,
            "isCancelable": true,
            "advanceBookingHour": 48,
            "advanceCancellationHours": 48,
            "maxPassengerPerOrder": 6,
            "prebookingRequiredInfo": [
                1
            ]
        },
        "serviceTerms": {
            "childPolicies": "Free admission is granted to children under 3 years old.",
            "serviceNotices": "Access is only granted with a valid membership or an E-pass."
        },
        "imagesList": [
            {
                "url": "https://image.dragonpass.com/uploadFile/images/test.png",
                "order": 1
            }
        ],
        "lastUpdatedTime": "2025-05-01T10:00:00+00:00",
        "extra": {
            "loungeInfo": {
                "area": 1,
                "routeTypes": [
                    1
                ],
                "terminal": "Terminal 1",
                "nearestGate": "A1",
                "tier": 1,
                "amenities": [
                    {
                        "amenityCode": "T001",
                        "amenityName": "Wifi",
                        "amenityIcon": "https://image.dragonpass.com/uploadFile/images/amenities/test.png"
                    }
                ]
            }
        }
    }
}

Fast Track

{
    "code": 0,
    "data": {
        "language": "en-US",
        "module": 2,
        "resourceId": "C00001",
        "resourceName": "DragonPass Fast Track Lane",
        "locationInfo": {
            "city": "Manchester",
            "countryOrRegion": "GB",
            "continent": "Europe",
            "transportHubId": "A00001",
            "transportHubName": "Manchester Airport",
            "iata": "MAN",
            "location": "FastTrack is located at the security entrance.",
            "timezone": "Europe/London"
        },
        "businessHours": [
            {
                "day": 1,
                "times": {
                    "type": "STANDARD",
                    "detail": "00:00-23:59"
                }
            }
        ],
        "prebookingPolicy": {
            "isBookable": true,
            "isCancelable": true,
            "advanceBookingHour": 48,
            "advanceCancellationHours": 48,
            "maxPassengerPerOrder": 6,
            "prebookingRequiredInfo": [
                1
            ]
        },
        "serviceTerms": {
            "childPolicies": "Free admission is granted to children under 3 years old.",
            "serviceNotices": "Access is only granted with a valid membership or an E-pass."
        },
        "imagesList": [
            {
                "url": "https://image.dragonpass.com/uploadFile/images/test.png",
                "order": 1
            }
        ],
        "lastUpdatedTime": "2025-05-01T10:00:00+00:00",
        "extra": {
            "fastTrackInfo": {
                "routeTypes": [
                    1
                ],
                "terminal": "Terminal 1"
            }
        }
    }
}

Set Meal(Lounge Alternative)

{
    "code": 0,
    "data": {
        "language": "en-US",
        "module": 4,
        "resourceId": "R00001",
        "resourceName": "DragonPass Dining Restaurant",
        "locationInfo": {
            "city": "Manchester",
            "countryOrRegion": "GB",
            "continent": "Europe",
            "transportHubId": "A00001",
            "transportHubName": "Manchester Airport",
            "iata": "MAN",
            "location": "Airside - After security check and passport control",
            "timezone": "Europe/London"
        },
        "businessHours": [
            {
                "day": 1,
                "times": {
                    "type": "STANDARD",
                    "detail": "00:00-23:59"
                }
            }
        ],
        "prebookingPolicy": {
            "isBookable": false,
            "isCancelable": false,
            "advanceBookingHour": null,
            "advanceCancellationHours": null,
            "maxPassengerPerOrder": null,
            "prebookingRequiredInfo": null
        },
        "serviceTerms": {
            "childPolicies": "Free admission is granted to children under 3 years old.",
            "serviceNotices": "Access is only granted with a valid membership or an E-pass."
        },
        "imagesList": [
            {
                "url": "https://image.dragonpass.com/uploadFile/images/test.png",
                "order": 1
            }
        ],
        "lastUpdatedTime": "2025-05-01T10:00:00+00:00",
        "extra": {
            "diningInfo": {
                "diningOptions": [
                    {
                        "module": 3,
                        "optionName": "Set Meal",
                        "description": "One set meal can be redeemed for each transaction.",
                        "value": null,
                        "currency": null
                    }
                ],
                "area": 1,
                "routeTypes": [
                    1
                ],
                "terminal": "Terminal 1",
                "nearestGate": "A1",
                "tier": 1,
                "amenities": [
                    {
                        "amenityCode": "T001",
                        "amenityName": "Wifi",
                        "amenityIcon": "https://image.dragonpass.com/uploadFile/images/amenities/test.png"
                    }
                ]
            }
        }
    }
}

Dining Coupon

{
    "code": 0,
    "data": {
        "language": "en-US",
        "module": 4,
        "resourceId": "R00001",
        "resourceName": "DragonPass Dining Restaurant",
        "locationInfo": {
            "city": "Manchester",
            "countryOrRegion": "GB",
            "continent": "Europe",
            "transportHubId": "A00001",
            "transportHubName": "Manchester Airport",
            "iata": "MAN",
            "location": "Airside - After security check and passport control",
            "timezone": "Europe/London"
        },
        "businessHours": [
            {
                "day": 1,
                "times": {
                    "type": "STANDARD",
                    "detail": "00:00-23:59"
                }
            }
        ],
        "prebookingPolicy": {
            "isBookable": false,
            "isCancelable": false,
            "advanceBookingHour": null,
            "advanceCancellationHours": null,
            "maxPassengerPerOrder": null,
            "prebookingRequiredInfo": null
        },
        "serviceTerms": {
            "childPolicies": "Free admission is granted to children under 3 years old.",
            "serviceNotices": "Access is only granted with a valid membership or an E-pass."
        },
        "imagesList": [
            {
                "url": "https://image.dragonpass.com/uploadFile/images/test.png",
                "order": 1
            }
        ],
        "lastUpdatedTime": "2025-05-01T10:00:00+00:00",
        "extra": {
            "diningInfo": {
                "diningOptions": [
                    {
                        "module": 4,
                        "optionName": "30 USD Coupon",
                        "description": "30.00 USD coupon to redeem against your total bill.",
                        "value": 30,
                        "currency": "USD"
                    }
                ],
                "area": 1,
                "routeTypes": [
                    1
                ],
                "terminal": "Terminal 1",
                "nearestGate": "A1",
                "tier": 1,
                "amenities": [
                    {
                        "amenityCode": "T001",
                        "amenityName": "Wifi",
                        "amenityIcon": "https://image.dragonpass.com/uploadFile/images/amenities/test.png"
                    }
                ]
            }
        }
    }
}

Fitness

{
    "code": 0,
    "data": {
        "language": "en-US",
        "module": 1,
        "resourceId": "F00001",
        "resourceName": "DragonPass Fitness Club",
        "locationInfo": {
            "city": "Manchester",
            "countryOrRegion": "GB",
            "continent": "Europe",
            "transportHubId": null,
            "transportHubName": null,
            "iata": "MAN",
            "location": "Manchester M90 1QX",
            "timezone": "Europe/London"
        },
        "businessHours": [
            {
                "day": 1,
                "times": {
                    "type": "STANDARD",
                    "detail": "00:00-23:59"
                }
            }
        ],
        "prebookingPolicy": {
            "isBookable": true,
            "isCancelable": true,
            "advanceBookingHour": 48,
            "advanceCancellationHours": 48,
            "maxPassengerPerOrder": 1,
            "prebookingRequiredInfo": [
                1
            ]
        },
        "serviceTerms": {
            "childPolicies": "Children are not allowed in this area",
            "serviceNotices": "Access is only granted with a valid membership or an E-pass."
        },
        "imagesList": [
            {
                "url": "https://image.dragonpass.com/uploadFile/images/test.png",
                "order": 1
            }
        ],
        "lastUpdatedTime": "2025-05-01T10:00:00+00:00",
        "extra": {
            "fitnessInfo": null
        }
    }
}

eSIM

{
    "code": 0,
    "data": {
        "language": "en-US",
        "module": 8,
        "resourceId": "E00001",
        "resourceName": "eSIM United Kingdom",
        "locationInfo": null,
        "businessHours": null,
        "prebookingPolicy": {
            "isBookable": true,
            "isCancelable": true,
            "advanceBookingHour": null,
            "advanceCancellationHours": null,
            "maxPassengerPerOrder": null,
            "prebookingRequiredInfo": []
        },
        "serviceTerms": {
            "childPolicies": null,
            "serviceNotices": "The eSIM must be installed and activated on a compatible mobile device within 1 year from the date of purchase. Failure to do so may result in the eSIM becoming invalid or unusable."
        },
        "imagesList": [
            {
                "url": "https://image.dragonpass.com/uploadFile/images/test.png",
                "order": 1
            }
        ],
        "lastUpdatedTime": "2025-05-01T10:00:00+00:00",
        "extra": {
            "esimInfo": {
                "coverage": {
                    "type": 1,
                    "regions": [
                        "GB"
                    ],
                    "rawText": "United Kingdom"
                }
            }
        }
    }
}

Retrieve Resouces Options

Use the module-specific API endpoint to retrieve the list of available options within the resource.

Fitness: /resources/fitness/{resourceId}/schedule

eSIM: /resources/esims/{resourceId}/options

The structure of returned options may vary across different modules. Please refer to the corresponding API for details.

Fitness

Retrieve Fitness Resources Schedule - Response

{
    "resourceId": "F00001",
    "resourceName": "DragonPass Fitness Club",
    "schedules": [
        {
            "date": "2025-10-01",
            "optionList": [
                {
                    "optionId": "F00001-01",
                    "optionName": "Hatha Yoga",
                    "optionType": 2,
                    "startTime": "10:00",
                    "endTime": "11:00"
                },
                {
                    "optionId": "F00001-02",
                    "optionName": "Hatha Yoga",
                    "optionType": 2,
                    "startTime": "11:00",
                    "endTime": "12:00"
                },
                {
                    "optionId": "F00001-dayPass",
                    "optionName": "Day Pass",
                    "optionType": 1,
                    "startTime": "08:00",
                    "endTime": "20:00"
                }
            ]
        },
        {
            "date": "2025-10-01",
            "optionList": [
                {
                    "optionId": "F00001-03",
                    "optionName": "Super Fun Boxing",
                    "optionType": 2,
                    "startTime": "10:00",
                    "endTime": "11:00"
                },
                {
                    "optionId": "F00001-04",
                    "optionName": "Super Fun Boxing",
                    "optionType": 2,
                    "startTime": "11:00",
                    "endTime": "12:00"
                }
            ]
        }
    ]
}

eSIM

Retrieve eSIM Resouces Options - eSIM - Response

{
    "code": 0,
    "data": {
        "pagination": {
            "pageSize": 10,
            "pageNumber": 1,
            "totalNumber": 3
        },
        "resourceId": "E00001",
        "resourceName": "eSIM United Kingdom",
        "optionList": [
            {
                "optionId": "E00001-01",
                "optionName": "eSIM United Kingdom - 10GB 5Days",
                "duration": 5,
                "dataMode": 1,
                "totalVolume": 10,
                "unit": 1
            },
            {
                "optionId": "E00001-02",
                "optionName": "eSIM United Kingdom - 1GB 1Day",
                "duration": 1,
                "dataMode": 1,
                "totalVolume": 1,
                "unit": 1
            },
            {
                "optionId": "E00001-03",
                "optionName": "eSIM United Kingdom - Unlimited 10Days",
                "duration": 10,
                "dataMode": 2,
                "totalVolume": -1,
                "unit": 3
            }
        ]
    }
}

Retrieve Resource Option Details

Use the module-specific API endpoint to retrieve the option details.

Fitness: /resources/fitness/{resourceId}/options/{optionId}

eSIM: /resources/esims/{resourceId}/options/{optionId}

Fitness

Retrieve Fitness Resource Option Details - Response

{
    "resourceId": "F00001",
    "resourceName": "DragonPass Fitness Club",
    "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

Retrieve eSIM Resource Option Details - Response

{
    "code": 0,
    "data": {
        "optionId": "E00001-01",
        "optionName": "eSIM United Kingdom - 10GB 5Days",
        "duration": 30,
        "dataMode": 1,
        "totalVolume": 30,
        "unit": 1,
        "notes": "Unlimited eSIM provides 1GB of high-speed data (where available), with unlimited usage at a reduced speed of 512 kbps after high-speed data is used up. High-speed data refreshes every 24 hours from the time of first use.",
        "speed": "5G",
        "providers": [
            {
                "provider": "DragonPass",
                "region": "GB"
            }
        ],
        "coverage": {
            "type": 1,
            "regions": [
                "GB"
            ],
            "rawText": "United Kingdom"
        }
    }
}

Overview#

List Transport Hubs#

Retrieve Transport Hub Details#

Retrieve Resources List#

Retrieve Resource Details#

Lounge#

Fast Track#

Set Meal(Lounge Alternative)#

Dining Coupon#

Fitness#

eSIM#

Retrieve Resouces Options#

Retrieve Resource Option Details#

Overview

List Transport Hubs

Retrieve Transport Hub Details

Retrieve Resources List

Retrieve Resource Details

Lounge

Fast Track

Set Meal(Lounge Alternative)

Dining Coupon

Fitness

eSIM

Retrieve Resouces Options

Retrieve Resource Option Details