Search and Price Flight Changes

Multi-OD change search. Each journey must provide origin, destination, and the target departure date; its OD must match the corresponding journey in the original order.
passengers is required and matched to order passengers by surname + givenNames. surname may be empty; givenNames is required.

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

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "cabinClass": "economy",
    "passengers": [
        {
            "surname": "ZHANG",
            "givenNames": "SAN"
        }
    ],
    "journeys": [
        {
            "origin": "PEK",
            "destination": "SHA",
            "departureDate": "2026-08-08"
        }
    ],
    "maxResultCount": 20
}

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_change_001",
        "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": "chg_sol_001",
                "source": "",
                "orderKey": "chg_ok_001",
                "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": 250,
                            "tax": 200,
                            "currency": "CNY",
                            "taxDetail": [
                                {
                                    "type": "YQ",
                                    "amount": 100
                                }
                            ],
                            "discount": 100,
                            "publishPriceDiff": 200,
                            "priceDiff": 180,
                            "taxDiff": 20,
                            "serviceFee": 50,
                            "serivceFee": 50
                        }
                    ],
                    "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