Search for resources

Overview

Retrieve detailed information on transport hubs and resources.

List Transport Hubs

→ Use the /transportHubs endpoint 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 the /transportHubs/{transportHubId} endpoint 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 Under A Specific Transport Hub

→ Use the /resources endpoint to retrieve the list of available resources at a specific transport hub.

Response

Retrieve Resources List - Response

{
    "code": 0,
    "data": {
        "pagination": {
            "pageSize": 10,
            "pageNumber": 1,
            "totalNumber": 2
        },
        "language": "en-US",
        "resources": [
            {
                "resourceId": "N00001",
                "resourceName": "DragonPass Lounge",
                "module": 1,
                "terminal": "Terminal 1",
                "area": 1,
                "routeType": [
                    1
                ],
                "image": "https://image.dragonpass.com/uploadFile/images/cover.png"
            },
            {
                "resourceId": "N00002",
                "resourceName": "DragonPass Lounge",
                "module": 1,
                "terminal": "Terminal 2",
                "area": 1,
                "routeType": [
                    1
                ],
                "image": "https://image.dragonpass.com/uploadFile/images/cover.png"
            }
        ]
    }
}

Retrieve Resource Details

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

The returned result provides detailed information about each resource, including:

Response

Retrieve Resource Details - Response

example:

Lounge

Fast Track

Dining

{
    "language": "en-US",
    "resourceId": "N00001",
    "resourceName": "DragonPass Lounge",
    "module": 1,
    "transportHubId": "A00001",
    "transportHubName": "Manchester Airport",
    "iata": "MAN",
    "city": "Manchester",
    "countryOrRegion": "GB",
    "continent": "Europe",
    "terminal": "Terminal 1",
    "area": 1,
    "routeTypes": [
        1
    ],
    "businessHours": [
        {
            "day": 1,
            "times": {
                "type": "STANDARD",
                "detail": "08:00-09:00"
            }
        }
    ],
    "location": "Airside - After security check and passport control",
    "nearestGate": "A1",
    "serviceTerms": {
        "childPolicies": "Free admission is granted to children under 3 year",
        "serviceNotices": "Access is only granted with a valid membership or through the use of an access E-pass."
    },
    "prebookingPolicy": {
        "isBookable": true,
        "isCancelable": true,
        "advanceBookingHour": 48,
        "advanceCancellationHours": 48,
        "maxPassengerPerOrder": 6
    },
    "prebookingRequiredInfo": {
        "firstName": true,
        "lastName": true,
        "email": true,
        "callingCode": true,
        "countryCode": true,
        "transportNumber": true
    },
    "imagesList": [
        {
            "url": "https://image.dragonpass.com/uploadFile/images/test1.png",
            "order": 1
        },
        {
            "url": "https://image.dragonpass.com/uploadFile/images/test2.png",
            "order": 2
        }
    ],
    "amenities": [
        {
            "amenityCode": "T001",
            "amenityName": "Wifi",
            "amenityIcon": "https://image.dragonpass.com/uploadFile/images/amenities/test.png"
        }
    ],
    "extra": {}
}

Check Prebooking Resource Availability

For prebooking resources, use the /resources/prebookings/availability endpoint to retrieve detailed availability and pricing information for resources that match the specified search criteria.

Request

When neither membershipId nor ePassId is not provided, the API will only return availability information without reserving the availability.

When an membershipId or ePassId is provided, the corresponding availability will be reserved. If the same membershipId or ePassId is sent again, the previously reserved availability will be released, and new availability will be reserved in its place.

Check Prebooking Resource Availability - Request

{
    "ePassId": "8888000066668888",
    "resourceId": "N00001",
    "prebookingDate": "2025-10-01T10:30",
    "adultCount": 1,
    "childCount": 0
}

Response

The prebookingToken will only be returned if the timeslot is available. This token is required to proceed with order creation.

Based on program and resource settings, dynamic pricing for specific resources may be returned according to the search criteria.

Check Prebooking Resource Availability - Response

{
    "available": true,
    "prebookingToken": "85c69b8e790befc7e94870ec269c3f1d",
    "validUntil": 1923263999,
    "price": {
        "dynamicPrice": true,
        "currency": "USD",
        "adultRate": "6.00",
        "childRate": "6.00"
    }
}

IMG parameters

DragonPass allows you to use one or more parameters to process images. You can also encapsulate multiple IMG parameters in a style and use the style to process images.

If you specify multiple IMG parameters, DragonPass will process in the following order.

Resize

Resize the image to a width of 500px：resize,w_500

Resize the image to a height of 200px：resize,h_200

Specifies the type of the resize action：resize,m_lfit

The following URL is used to process the image based on the preceding parameter: https://image.dragonpass.com/uploadFile/images/test1.png?x-oss-process=image/resize,m_lfit,w_500,h_200.

Quality adjustment

Set the relative quality of the image to 80%: quality,q_80

The following URL is used to process the image based on the preceding parameter: https://image.dragonpass.com/uploadFile/images/test1.png?x-oss-process=image/quality,q_80.

Overview#

List Transport Hubs#

Retrieve Transport Hub Details#

Retrieve Resources List Under A Specific Transport Hub#

Retrieve Resource Details#

Check Prebooking Resource Availability#

IMG parameters#

Resize#

Quality adjustment#

Overview

List Transport Hubs

Retrieve Transport Hub Details

Retrieve Resources List Under A Specific Transport Hub

Retrieve Resource Details

Check Prebooking Resource Availability

IMG parameters

Resize

Quality adjustment