Batch Shipment Subscription API

The number of subscriptions per request is limited to 30.
The extendNo extended field is mandatory exclusively for Xiamen Airlines and JD Airlines; for other airlines any assigned value is invalid information.
Different scenarios use different subscription methods; please refer to the subscription notes below 👇.

Subscription Type Notes for Different Scenarios

Scenario	Subscription Type	Parameters	Remarks
Normal subscription	Subscribe with the air waybill number	referenceNo=Air waybill number carrierCd="" (airline 2-letter code / ""=auto-detect)	carrierCd can be empty; Trackingeyes auto-detects it from the first three digits of the document number
Xiamen Airlines	Subscribe with the air waybill number + origin + destination	referenceNo=Air waybill number carrierCd="" (airline 2-letter code / ""=auto-detect) extendNo={"org": "origin","dest": "destination"}	In this scenario the extended field must upload the org and dest parameters in the required format; refer to the Xiamen Airlines location codes in the
JD Airlines New (service must be activated separately)	Subscribe with the air waybill number + flight number + estimated time	referenceNo=Air waybill number carrierCd="" (airline 2-letter code / ""=auto-detect) extendNo={"flightNo": "flight number","pEtd": "estimated flight departure date"} serviceType=AF (default AF)	In this scenario the extended field must upload flightNo (flight number) and pEtd (estimated flight departure date) in the required format; date format: yyyy-mm-dd. Only estimated and actual arrival/departure information is provided; other status event information cannot be provided
Supplement arrival/departure events with flight status data New (service must be activated separately)	Subscribe to the consolidated API data (air + flight status)	referenceNo=Air waybill number carrierCd="" (airline 2-letter code / ""=auto-detect) serviceType=AF (must specify whether flight status data needs to be supplemented for this shipment)	The consolidated API does not support subscribing to flight status data only; if only flight status is needed, please use the flight status data API

Request

Query Params

Body Params application/json

Example

[
    {
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "referenceNo": "17203718536",
        "carrierCd": "CV",
        "extendNo": "",
        "customer": "",
        "customerService": "",
        "remark": ""
    },
    {
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "referenceNo": "731-98211002",
        "carrierCd": "",
        "extendNo": {
            "org": "XMN",
            "dest": "BKK"
        },
        "customer": "",
        "customerService": "",
        "remark": ""
    },
    {
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "referenceNo": "619-09858912",
        "carrierCd": "JG",
        "extendNo": {
            "flightNo": "8B861",
            "pEtd": "2026-09-10"
        },
        "customer": "",
        "customerService": "",
        "remark": "",
        "serviceType": "AF"
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": [
        {
            "deliveryNo": "",
            "orderNo": "",
            "referenceNo": "17203718536",
            "carrierCd": "CV",
            "serviceType": "A",
            "extendNo": "",
            "customer": "",
            "customerService": "",
            "remark": "",
            "billCreateTime": "2025-02-20 16:49:05",
            "id": "1892496683351281664",
            "localKey": "",
            "itemCode": 200,
            "itemCodeDesc": "success",
            "itemMessage": ""
        },
        {
            "deliveryNo": "",
            "orderNo": "",
            "referenceNo": "731-98211002",
            "carrierCd": "MF",
            "serviceType": "A",
            "extendNo": {
                "org": "XMN",
                "dest": "BKK"
            },
            "customer": "",
            "customerService": "",
            "remark": "",
            "billCreateTime": "2025-02-20 16:49:05",
            "id": "1892496683351282952",
            "localKey": "",
            "itemCode": 200,
            "itemCodeDesc": "success",
            "itemMessage": ""
        },
        {
            "deliveryNo": "",
            "orderNo": "",
            "referenceNo": "619-09858912",
            "carrierCd": "JG",
            "serviceType": "AF",
            "extendNo": {
                "flightNo": "8B861",
                "pEtd": "2026-09-10"
            },
            "customer": "",
            "customerService": "",
            "remark": "",
            "billCreateTime": "2026-09-09 15:03:01",
            "id": "2097581523867275264",
            "localKey": "",
            "itemCode": 200,
            "itemCodeDesc": "success",
            "itemMessage": ""
        }
    ]
}