Aggregated Search by Keyword

POST

https://developer-sandbox.dragonpass.com/api/v2/search

Last modified:2026-03-31 08:26:19

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 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": 50
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://developer-sandbox.dragonpass.com/api/v2/search' \
--header 'X-Program-ID: ' \
--header 'X-Request-ID: {{$string.uuid}}' \
--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": 50
}'

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 2026-03-31 08:26:19

Generate Access Token

Retrieve Available Modules by Location