DragonPass API Developer Platform
v2
  • v2
  • v1
HomepageOfficial SiteContact Us
HomepageOfficial SiteContact Us
API Version
v2
  • v2
  • v1
  1. Search
  • Implementation Guide
    • DragonPass Modules
    • Get Started
    • Our API Solution
  • Development Guide
    • Response Format
    • Error Codes
    • Multiple Language Support and Fallback
    • UI Design Guidelines
    • Authentication
    • Sandbox Order Simulation
  • DragonPass API Push Event
    • Instructions
    • Lounge/Dining Walk-in Redemption Event
    • Prebooking Order Status Change Event
    • Resource Update Push Service
  • Using the API
    • Search for Resources
      • Search for Resources
      • Check Prebooking Resource & Option Availability
      • Pricing Query
      • Image Parameters
    • Order Lifecycle
      • Walk-in & Prebooking Order
      • Order Status Enumeration
    • E-pass
      • Querying E-pass Usage Orders and Details
      • Issuing, Querying, and Cancelling an E-pass
      • Utilizing The E-pass
        • Lounge
        • Fast Track
        • Dining
        • Fitness
        • eSIM
        • Cross Module
    • Membership
      • Manage Memberships & Entitlements
      • Querying Membership Usage Orders and Details
      • Utilizing DragonPass Membership
        • Lounge
        • Fast Track
        • Dining
        • Fitness
        • eSIM
    • User
      • User Management
  • Release Notes
    • 2026
    • 2025
  • Migration Guide
    • From V1 to V2
  • API Reference
    • Authentication
      • Generate Access Token
    • User Management
      • User Creation
      • Update User Information
      • Retrieve User Information
      • Retrieve User E-passes List
      • Retrieve User Memberships List
      • Delete A User
    • Search
      • Retrieve Available Modules by Location
        GET
      • Aggregated Search by Keyword
        POST
    • Transport Hubs
      • Retrieve Transport Hub
      • Retrieve Transport Hub Details
    • Resources
      • Retrieve Resource List
        • Retrieve Resources List
      • Search For Resources
        • Retrieve Resource Details
        • List Updated Resources
      • Check Resource Availability
        • Check Prebooking Resource Availability
        • Check Prebooking Option Availability
      • Fitness
        • Retrieve Fitness Resources Schedule
        • Retrieve Fitness Resource Option Details
      • eSIM
        • Retrieve eSIM Resouces Options
        • Retrieve eSIM Resource Option Details
      • Pricing
        • Retrieve Resource Pricing Information
        • Retrieve Prebooking Option Pricing Information
    • Entitlement Management
      • Update Membership Entitlements
      • Retrieve Membership Entitlement Information
    • Membership Management
      • Membership Registration
      • Update A Membership
      • Retrieve Membership Information
      • Generate Membership Dynamic QR Codes
      • Change Membership Program(Upgrade/Downgrade)
    • Orders Management
      • Preview Orders
        • Membership
          • Preview Membership Prebooking Order
      • Create Orders
        • E-pass
          • Issue An E-pass
            • Create E-pass Order
          • Lounge Prebooking
            • Create E-pass Prebooking Order - Lounge
            • Create E-pass with Prebooking Order - Lounge
          • Fast Track
            • Create E-pass Prebooking Order - Fast Track
            • Create E-pass with Prebooking Order - Fast Track
          • Fitness
            • Create E-pass Prebooking Order - Fitness
            • Create E-pass with Prebooking Order - Fitness
          • eSIM
            • Create E-pass Prebooking Order - eSIM
            • Create E-pass with Prebooking Order - eSIM
            • Top up eSIM data package - E-pass
        • Membership
          • Create Membership Prebooking Order - Lounge
          • Create Membership Prebooking Order - Fast Track
          • Create Membership Prebooking Order - Fitness
          • Create Membership Prebooking Order - eSIM
          • Top up eSIM data package - Membership
      • Retrieve Order List
        • Retrieve E-pass Order List
        • Retrieve Membership Order List
      • Cancel Orders
        • Cancel an Order
      • Retrieve Order Details
        • E-pass
          • Retrieve E-pass Details
          • Retrieve E-pass Usage Order Details
        • Membership
          • Retrieve Membership Usage Order Details
      • Module Specific APIs
        • Fitness
          • Fitness Order Check-In
        • eSIM
          • Retrieve eSIM Order Live Extended Details
          • Check eSIM Top-up Availability
          • Retrieve eSIM Data Packages
    • [Sandbox Only] Simulation
      • Lounge
        • Simulate Lounge Redemption - Walk in
        • Simulate Lounge Redemption - Prebooking
        • Simulate Lounge Order Cancellation
      • Fast Track
        • Simulate Fast Track Redemption - Prebooking
        • Simulate Fast Track Order Cancellation
    • Push Event Recovery
      • Push Event Recovery
  • Our Team
  1. Search

Aggregated Search by Keyword

POST
https://developer-sandbox.dragonpass.com/api/v2/search
Last modified:2025-12-25 07:55:04
This API allows corporate clients to perform an aggregated keyword-based search with optional geolocation constraints. The search results are relevance-ranked and limited to the following 4 entity types, each type returns a different data structure:
Transport Hub – Searchable by IATA code or transport hub name
Country or Region – Searchable by ISO 2-letter code or name
City – Searchable by city name
Module (e.g., Lounge, Fast Track, Dining) – Searchable by module name
This endpoint provides a unified entry point to help users quickly locate supported services across multiple geographies.
This endpoint is currently in beta and may be updated. The search algorithm is under active optimization, so results may change over time.

Request

Authorization
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Header Params

Body Params application/json

Example
{
    "keyword": "man",
    "language": "en-US",
    "pageSize": 10,
    "pageNumber": 1,
    "searchFields": [
        1,
        2,
        3
    ],
    "enableFuzzy": true,
    "sortBy": [
        1
    ],
    "latitude": "53.467",
    "longitude": "-2.233",
    "radius": 100
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer-sandbox.dragonpass.com/api/v2/search' \
--header 'X-Program-ID;' \
--header 'X-Request-ID;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keyword": "man",
    "language": "en-US",
    "pageSize": 10,
    "pageNumber": 1,
    "searchFields": [
        1,
        2,
        3
    ],
    "enableFuzzy": true,
    "sortBy": [
        1
    ],
    "latitude": "53.467",
    "longitude": "-2.233",
    "radius": 100
}'

Responses

🟢200成功
application/json
Body

Example
{
    "code": 0,
    "data": {
        "keyword": "man",
        "pagination": {
            "pageSize": 10,
            "pageNumber": 1,
            "totalNumber": 4
        },
        "results": [
            {
                "type": 1,
                "transportHubId": "A00001",
                "transportHubName": "Manchester Airport",
                "transportHubType": 1,
                "iata": "MAN",
                "cityId": "Z01",
                "cityName": "Manchester",
                "countryOrRegion": "GB",
                "countryOrRegionName": "United Kingdom",
                "latitude": 53.365,
                "longitude": -2.272
            },
            {
                "type": 2,
                "cityId": "Z01",
                "cityName": "Manchester",
                "countryOrRegion": "GB",
                "countryOrRegionName": "United Kingdom",
                "latitude": 53.365,
                "longitude": -2.272
            },
            {
                "type": 3,
                "countryOrRegionName": "Oman",
                "countryOrRegion": "US"
            },
            {
                "type": 4,
                "moduleName": "Lounge",
                "module": 1
            }
        ]
    }
}
Modified at 2025-12-25 07:55:04
Previous
Retrieve Available Modules by Location
Next
Retrieve Transport Hub