Batch Shipment Subscription API

The number of subscriptions per request is limited to 30.

code=warning means a partial failure; determine the reason from the error code.

The consolidated API distinguishes between Standard CT and Enhanced CTP; pay attention to the parameters.

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	B/L No. / Booking No. / Container No. subscription	"referenceNo": "B/L No. / Booking No. / Container No." (choose one of the three) "blType":"" (BL=B/L No. / BK=Booking No. / CN=Container No. / ""=auto-detect) "carrierCd": "Ocean carrier code"	blType can be empty; Trackingeyes auto-detects it from the document number
One shipment with multiple containers but only one container's information is needed	B/L No. / Booking No. + specified single container subscription	"referenceNo": "B/L No. / Booking No." (choose one) "ctnrNo": "specified container number" "blType":"" (BL=B/L No. / BK=Booking No. / ""=auto-detect) "carrierCd": "Ocean carrier code" "extendNo":{"ctnrTrackId":"Y"}	1. In this scenario the specific single container number must be uploaded to ctnrNo, and the extended field must upload the ctnrTrackId parameter in the required format 2. If information for multiple containers needs to be returned, each container number must be subscribed separately in this mode
Sinotrans (SINO)	B/L No. subscription for Sinotrans (SINO)	"referenceNo": "B/L No. "blType":"" (BL=B/L No. / ""=auto-detect) "carrierCd": "Ocean carrier code" "extendNo": {"ctnrNo":"one of the container numbers"}	1. Container-number subscription can be used directly 2. When subscribing with a B/L No., the extended field must upload the ctnrNo parameter in the required format 3. To return the information of a specified container, ctnrNo must be that container number
The current status on the ocean carrier's official website is pick-up or empty-return, not a new process	Historical container subscription	"referenceNo": "Container No. "blType":"" (CN=Container No. / ""=auto-detect) "carrierCd": "Ocean carrier code" "extendNo":{"IncludeHistoryId":"Y"}	1. In this scenario the system automatically determines it as a historical container. To obtain this data, the extended field must upload the IncludeHistoryId parameter in the required format 2. If the current status on the ocean carrier's official website is not pick-up or empty-return, assigning this scenario parameter makes the system return the latest current status instead of the status of the previous process
The ocean carrier is unknown	Ocean carrier auto-detect subscription (service must be activated separately)	"referenceNo": "Subscription No. "blType":"" (BL=B/L No. / BK=Booking No. / CN=Container No. / ""=auto-detect) "carrierCd": "AUTO
Terminal data is needed to supplement release and inspection	Consolidated API data subscription (ocean carrier + terminal) (service must be activated separately)	"referenceNo": "B/L No. / Booking No. / Container No. (choose one of the three) "blType":"" (BL=B/L No. / BK=Booking No. / CN=Container No. / ""=auto-detect) "carrierCd": "Ocean carrier code" "polCd":"Port of loading code (polCd for export / podCd for import) "serviceType":"CT/CTP" (select the parameter according to the purchased type)	1. The consolidated API does not support subscribing to terminal data only; if only terminal data is needed, please use the port area data API 2. When using the consolidated API with a container number or the consolidated API with a specified container, the etd (estimated sailing time) must also be provided New 3. To return the information of a specified container, the ctnrNo and ctnrTrackId parameters must also be uploaded as in type 4 above 4. CTP = enhanced consolidated API

Request

Query Params

Body Params application/json

Example

[
    {
        "localKey": "001",
        "referenceNo": "177QAZAZXTCN0541",
        "blType": "",
        "carrierCd": "MSC",
        "customerService": null,
        "noticeEmail": "张三<123456@zs.com>;李四<654321@ls.com>",
        "serviceType": "C"
    },
    {
        "localKey": "002",
        "referenceNo": "N226269468",
        "ctnrNo": "TEMU8770940",
        "blType": "",
        "carrierCd": "YML",
        "extendNo": {
            "ctnrTrackId": "Y"
        },
        "serviceType": "C"
    },
    {
        "localKey": "003",
        "referenceNo": "SNLFSKALB61601",
        "blType": "BL",
        "carrierCd": "SINO",
        "extendNo": {
            "CtnrNo": "BHCU4987386"
        },
        "serviceType": "C"
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "code": 200,
    "type": "success",
    "message": "",
    "time": "2026-01-10 19:49:31",
    "result": [
        {
            "resultType": "订阅成功",
            "resultTypeCd": "success",
            "error": "",
            "id": "000001",
            "deliveryNo": "",
            "orderNo": "",
            "localKey": "001",
            "referenceNo": "177QAZAZXTCN0541",
            "ctnrNo": "",
            "carrierCd": "MSC",
            "trackStatus": "跟踪中",
            "trackStatusCd": "T",
            "errorMessage": "",
            "errorStatus": "",
            "billCreateTime": "2026-01-10 19:49:31",
            "dataStatus": "",
            "blType": "BL"
        },
        {
            "resultType": "订阅成功",
            "resultTypeCd": "success",
            "error": "",
            "id": "000002",
            "deliveryNo": "",
            "orderNo": "",
            "localKey": "002",
            "referenceNo": "N226269468",
            "ctnrNo": "TEMU8770940",
            "carrierCd": "YML",
            "trackStatus": "跟踪中",
            "trackStatusCd": "T",
            "errorMessage": "",
            "errorStatus": "",
            "billCreateTime": "2026-01-10 19:49:31",
            "dataStatus": "",
            "blType": "BL"
        }，
        {
            "resultType": "订阅成功",
            "resultTypeCd": "success",
            "error": "",
            "id": "000003",
            "deliveryNo": "",
            "orderNo": "",
            "localKey": "003",
            "referenceNo": "SNLFSKALB61601",
            "ctnrNo": "BHCU4987386",
            "carrierCd": "SINO",
            "trackStatus": "跟踪中",
            "trackStatusCd": "T",
            "errorMessage": "",
            "errorStatus": "",
            "billCreateTime": "2026-01-10 19:49:31",
            "dataStatus": "",
            "blType": "BL"
        }
    ]
}