查询航班票号状态

POST

/openapi/v3/flight/ticket-status

根据订单号查询票号状态，可按 PNR、航司 PNR、票号或乘客姓名过滤。

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

{
    "orderId": "FO202607090001",
    "pnr": "ABC123",
    "airPnr": "CA1ABC",
    "ticketNos": [
        "9991234567890"
    ],
    "passengers": [
        {
            "surname": "ZHANG",
            "givenNames": "SAN"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v3/flight/ticket-status' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "orderId": "FO202607090001",
    "pnr": "ABC123",
    "airPnr": "CA1ABC",
    "ticketNos": [
        "9991234567890"
    ],
    "passengers": [
        {
            "surname": "ZHANG",
            "givenNames": "SAN"
        }
    ]
}'

Responses

🟢200

application/json

查询成功。

Bodyapplication/json

Example

{
    "code": 0,
    "message": "ok",
    "realErrorMsg": "",
    "data": {
        "items": [
            {
                "ticketNo": "9991234567890",
                "passengerName": "ZHANG/SAN",
                "passengerType": "adult",
                "pnr": "ABC123",
                "airPnr": "CA1ABC",
                "platingCarrier": "CA",
                "ticketStatus": "issuing",
                "usedStatus": "used",
                "refundStatus": "refunded",
                "voidStatus": "voided",
                "couponStatus": [
                    {
                        "segmentNo": 1,
                        "flightNo": "CA1234",
                        "departure": "PEK",
                        "arrival": "SHA",
                        "status": "OPEN FOR USE"
                    }
                ],
                "issueTime": "2026-07-09",
                "lastUpdatedAt": "2026-07-09 12:00:00"
            }
        ]
    }
}

⚪default

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

行李直挂 / 中转行李查询

下载电子客票行程单