Search Flights

POST

/openapi/v3/flight/shopping

Search for flight solutions by journey, cabin class, passenger count, and filtering criteria.

Important filtering behavior:

Both includeAirlines and excludeAirlines filter by marketing carrier.

maxPrice filters the final price after markup and policy application.

alliances is applied as a post-processing alliance filter.

The effective maxWaitTime is the smallest positive value among the request value, OTA CircuitBreakerDuration, and the 30000 ms default.

Request

Authorization

API Key

Add parameter in header

code

Example:

code: ********************

API Key

Add parameter in header

timestamp

Example:

timestamp: ********************

API Key

Add parameter in header

signature

Example:

signature: ********************

Body Params application/jsonRequired

Example

{
    "journeys": [
        {
            "origin": "BJS",
            "destination": "BKK",
            "departureDate": "2026-08-01"
        }
    ],
    "cabinClass": "economy",
    "passengers": {
        "adult": 1,
        "child": 0,
        "infant": 0
    },
    "includeAirlines": [
        "CX"
    ],
    "alliances": [
        "OW"
    ],
    "requirements": {
        "freeBaggage": true,
        "noMultiAirport": true
    },
    "configs": {
        "allowedTransport": [
            "AIR"
        ],
        "approachDepartureTime": 6
    },
    "maxWaitTime": 20000
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v3/flight/shopping' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "journeys": [
        {
            "origin": "BJS",
            "destination": "BKK",
            "departureDate": "2026-08-01"
        }
    ],
    "cabinClass": "economy",
    "passengers": {
        "adult": 1,
        "child": 0,
        "infant": 0
    },
    "includeAirlines": [
        "CX"
    ],
    "alliances": [
        "OW"
    ],
    "requirements": {
        "freeBaggage": true,
        "noMultiAirport": true
    },
    "configs": {
        "allowedTransport": [
            "AIR"
        ],
        "approachDepartureTime": 6
    },
    "maxWaitTime": 20000
}'

Responses

🟢200

application/json

Query completed successfully.

Bodyapplication/json

Example

⚪default

Modified at 2026-07-21 08:28:13

Price Specified Segments