Search Flights - STTS OPEN API

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

Important filtering behavior:

origin and destination may be city or airport IATA codes. Airport codes are normalized to their city codes before supplier routing and cache-key calculation, while response segments still contain the actual airports.

Both includeAirlines and excludeAirlines filter by operating carrier, not marketing carrier.

flightsAllowedOperatingCarriers is an additional operating-carrier allowlist; suppliers are skipped when the request matches the LinkstarGDS disabled list.

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: ********************

Header Params

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

Responses

🟢200

application/json

Query completed successfully.

Bodyapplication/json

Example

{
    "code": 0,
    "message": "ok",
    "realErrorMsg": "",
    "data": {
        "searchKey": "sk_001",
        "cursor": 0,
        "more": false,
        "segments": {
            "property1": {
                "id": "PEK-SHA-20260801-CA1234",
                "airline": "CA",
                "flightNo": "CA1234",
                "isCodeShare": false,
                "opAirline": "CA",
                "opFlightNo": "CA1234",
                "equipment": "738",
                "mealType": "Meal",
                "departure": "PEK",
                "departureDate": "2026-08-01",
                "departureTime": "08:00",
                "departureTerminal": "T3",
                "arrival": "SHA",
                "arrivalDate": "2026-08-01",
                "arrivalTime": "10:20",
                "arrivalTerminal": "T2",
                "distance": 1080,
                "flightTime": "2h20m",
                "stopovers": [
                    {
                        "city": "HGH",
                        "airport": "HGH",
                        "duration": "1h10m",
                        "arrivalTime": "10:00",
                        "departureTime": "11:10"
                    }
                ]
            },
            "property2": {
                "id": "PEK-SHA-20260801-CA1234",
                "airline": "CA",
                "flightNo": "CA1234",
                "isCodeShare": false,
                "opAirline": "CA",
                "opFlightNo": "CA1234",
                "equipment": "738",
                "mealType": "Meal",
                "departure": "PEK",
                "departureDate": "2026-08-01",
                "departureTime": "08:00",
                "departureTerminal": "T3",
                "arrival": "SHA",
                "arrivalDate": "2026-08-01",
                "arrivalTime": "10:20",
                "arrivalTerminal": "T2",
                "distance": 1080,
                "flightTime": "2h20m",
                "stopovers": [
                    {
                        "city": "HGH",
                        "airport": "HGH",
                        "duration": "1h10m",
                        "arrivalTime": "10:00",
                        "departureTime": "11:10"
                    }
                ]
            }
        },
        "solutions": [
            {
                "solutionId": "sol_2f4d3c",
                "source": "",
                "orderKey": "ok_9ecf",
                "priceDetail": {
                    "invoiceType": "normal",
                    "issuingAirline": "CA",
                    "saleAirline": "CA",
                    "productType": "publish",
                    "maxCount": 9,
                    "limitInfo": {
                        "nationalityAllows": [
                            "CN"
                        ],
                        "nationalityForbids": [
                            "US"
                        ],
                        "agePairs": [
                            {
                                "maxAge": 65,
                                "minAge": 18
                            }
                        ],
                        "allowedTravelDocuments": [
                            "passport"
                        ],
                        "passengerQualification": "",
                        "groupInfo": {
                            "max": 9,
                            "min": 2
                        }
                    },
                    "priceList": [
                        {
                            "passengerType": "adult",
                            "fareBasisCode": "YOWCN",
                            "brandCode": "ECONOMY",
                            "num": 1,
                            "publishPrice": 1000,
                            "price": 950,
                            "salePrice": 1000,
                            "tax": 200,
                            "currency": "CNY",
                            "taxDetail": [
                                {
                                    "type": "YQ",
                                    "amount": 100
                                }
                            ],
                            "discount": 100
                        }
                    ],
                    "officeNo": "BJS123",
                    "accountCode": "CORP001",
                    "isSelfProduct": false,
                    "isPrivate": false,
                    "productFlag": "",
                    "productName": "Economy Saver"
                },
                "journeys": [
                    {
                        "origin": "BJS",
                        "destination": "BKK",
                        "departureDate": "2026-08-01",
                        "departureTime": "08:00",
                        "departureTimeZone": "Asia/Shanghai",
                        "arrivalDate": "2026-08-01",
                        "arrivalTime": "15:00",
                        "arrivalTimeZone": "Asia/Bangkok",
                        "duration": "7h00m",
                        "transferNum": 1,
                        "segments": [
                            {
                                "coreSegmentId": "PEK-SHA-20260801-CA1234",
                                "cabinClass": "economy",
                                "cabinCode": "Y",
                                "subCabinCode": "Y1",
                                "fareBasis": "YOWCN",
                                "brandCode": "ECONOMY",
                                "availability": 9,
                                "stayTime": "2h10m"
                            }
                        ]
                    }
                ],
                "fareRules": {
                    "PEKSHA": [
                        {
                            "passengerType": "adult",
                            "canVoid": true,
                            "currency": "CNY",
                            "change": {
                                ">0": 300,
                                ">4": 200,
                                "<-4": 500
                            },
                            "refund": {
                                ">0": 500,
                                ">4": 300,
                                "<-4": 800
                            }
                        }
                    ]
                },
                "baggageRules": {
                    "PEKSHA": [
                        {
                            "passengerType": "adult",
                            "carryOn": {
                                "pieces": 1,
                                "weight": 7,
                                "unit": "KG"
                            },
                            "checked": {
                                "pieces": 1,
                                "weight": 23,
                                "unit": "KG"
                            }
                        }
                    ]
                },
                "requiredPassengerInfos": [
                    "type"
                ]
            }
        ]
    }
}

⚪default