DragonPass API Developer Platform
v1
  • v2
  • v1
HomepageOfficial SiteContact Us
HomepageOfficial SiteContact Us
API Version
v1
  • v2
  • v1
  1. Using the API
  • Implementation Guide
    • Get Started
    • DragonPass Modules
    • Our API Solution
  • Development Guide
    • Authentication
    • Response Format
    • Error Codes
    • Order Synchronization
    • UI Design Guidelines
  • Using the API
    • Search for resources
    • E-pass
      • Issuing, Querying, and Cancelling an E-pass
      • Querying E-pass Usage Orders and Details
      • Utilizing The E-pass
        • Lounge
        • Fast Track
        • Dining
    • Membership
      • Manage Memberships & Entitlements
      • Querying Membership Usage Orders and Details
      • Utilizing DragonPass Membership
        • Lounge
        • Fast Track
        • Dining
  • API reference
    • Authentication
      • Generate Access Token
    • Membership Management
      • Membership Registration
      • Update A Membership
      • Retrieve Membership Information
      • Generate Membership Dynamic QR Codes
    • Entitlement Management
      • Update Membership Entitlements
      • Retrieve Membership Entitlement Information
    • Transport Hubs
      • Retrieve Transport Hub
      • Retrieve Transport Hub Details
    • Resources
      • Retrieve Resource List
        • Retrieve Resources List Under A Specific Transport Hub
      • Search For Resources
        • Retrieve Resource Details
        • List Updated Resources
      • Check Resource Availability
        • Check Prebooking Resource Availability
    • Orders Management
      • Create Orders
        • E-pass
          • Issue An E-pass
            • Create E-pass Order
          • Lounge Prebooking
            • Create E-pass with Prebooking Order - Lounge
            • Create E-pass Prebooking Order - Lounge
          • Fast Track
            • Create E-pass Prebooking Order - Fast Track
            • Create E-pass with Prebooking Order - Fast Track
        • Membership
          • Create Membership Prebooking Order - Fast Track
          • Create Membership Prebooking Order - Lounge
      • Retrieve Order List
        • Retrieve E-pass Order List
        • Retrieve Membership Order List
      • Retrieve Order Details
        • E-pass
          • Retrieve E-pass Details
          • Retrieve E-pass Usage Order Details
        • Membership
          • Retrieve Membership Usage Order Details
      • Cancel Orders
        • Cancel an Order
  1. Using the API

Search for resources

Overview#

Retrieve detailed information on transport hubs and resources.
image.png

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.
Modified at 2025-06-04 10:53:12
Previous
UI Design Guidelines
Next
Issuing, Querying, and Cancelling an E-pass