Ocean Tracking Subscribe - Trackingeyes-API（旧英文版）

1.Each single subscription is limited to 30 items.
2.If you need to re-subscribe to the same order, the localKey must be unique for each subscription.
3.Different scenarios require different subscription methods. Please refer to the following instructions to subscribe.👇

Guidelines for Different Subscription Types of Interfaces

Subscription type	Parameter Description	Remarks
Subscribe to Bill of Lading Number / Booking Number	referenceNo=BL/BK,blType=""(BL=Bill of Lading number,BK=Booking number,Null Value=Automatic Recognition), carrierCd=Shipowner Code	-
Subscribe to Container number	referenceNo=CN ,blType=""(CN=Container number,Null Value=Automatic Recognition),carrierCd=Shipowner Code,extendNo={"IncludeHistoryId":"Y"}	If historical container data is required during the testing phase or due to business needs, the extended field extendNo must pass parameters in the specified format (e.g., "extendNo":{"IncludeHistoryId":"Y"}).
Shipowner Automatic Recognition Subscription	referenceNo=BL/BK/CN,blType=""(BL=Bill of Lading number,BK=Booking number,CN=Container number,Null Value=Automatic Recognition),carrierCd=AUTO	This subscription method requires additional service activation. Please contact the business team to complete the application.
Subscribe to Bill of Lading Number / Booking Number+Specified Container Number	referenceNo=BL/BK,ctnrNo=Specified Container Number,blType=""(BL=Bill of Lading number,BK=Booking number,Null Value=Automatic Recognition),carrierCd=Shipowner Code,extendNo={"ctnrTrackId":"Y"}	This subscription method returns only the specified container information for the subscribed number. Meanwhile, confirmation parameters must be uploaded for the extended field. If you need to retrieve information for multiple containers, you must subscribe to each container individually following this mode.
Subscribe to SINO Shipowner via Bill of Lading Number	referenceNo=BL,blType=""(BL=Bill of Lading number,Null Value=Automatic Recognition),carrierCd=Shipowner Code,extendNo={"ctnrNo":"Any one of the container numbers"}	Container numbers can be used for direct subscription. If subscribing via bill of lading number, the extended field extendNo must upload one of the container numbers in the specified format; if specified container information also needs to be returned, an additional field ctnrNo=Specified Container Number must be uploaded.
Subscribe to Comprehensive Interface Data	referenceNo=BL/BK/CN,blType=""(BL=Bill of Lading number,BK=Booking number,CN=Container number,Null Value=Automatic Recognition),carrierCd=Shipowner Code,polCd=Port of origin code,serviceType=CT	-

Request

Query Params

Body Params application/json

Example

[
    {
        "deliveryNo": null,
        "orderNo": null,
        "localKey": "",
        "referenceNo": "177QAZAZXTCN0541",
        "blType": "BL",
        "carrierCd": "MSC",
        "extendNo": null,
        "customer": null,
        "polCd": null,
        "customerService": null,
        "noticeEmail": null,
        "remark": null,
        "serviceType": "C",
    },
    {
        "deliveryNo": null,
        "orderNo": null,
        "localKey": "",
        "referenceNo": "SNLFSKALB61601",
        "blType": "BL",
        "carrierCd": "SINO",
        "extendNo": {"CtnrNo":"BHCU4987386"},
        "customer": null,
        "polCd": null,
        "customerService": null,
        "noticeEmail": null,
        "remark": null,
        "serviceType": "C",
    },
    {
        "deliveryNo": null,
        "orderNo": null,
        "localKey": "",
        "referenceNo": "6414918850",
        "blType": "",
        "carrierCd": "COSCO",
        "extendNo": null,
        "customer": null,
        "polCd": null,
        "customerService": null,
        "noticeEmail": null,
        "remark": null,
        "serviceType": "C"
     }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200sucess

application/json

Body

Example

{
    "code": 200,
    "type": "success",
    "message": "",
    "result": [
        {
            "resultType": "订阅成功",
            "resultTypeCd": "success",
            "error": "",
            "id": "627472342581317",
            "deliveryNo": null,
            "orderNo": null,
            "localKey": null,
            "referenceNo": "278342554",
            "ctnrNo": null,
            "carrierCd": "MSK",
            "trackStatus": "跟踪中",
            "trackStatusCd": "T",
            "errorMessage": "",
            "errorStatus": "T",
            "billCreateTime": "2024-12-28 11:31:32",
            "dataStatus": null,
            "blType": "BL"
        }
    ],
    "time": "2024-12-28 11:31:32"
}