1. Ocean Cargo Tracking
Trackingeyes-API
🇺🇸 English
  • 🇨🇳 中文
  • 🇺🇸 English
  • Authentication
    • OAuth
      POST
    • Get Port Codes
      GET
    • Get Carrier Codes
      GET
  • Ocean Data API
    • Ocean Data
      • Ocean Support List
      • Ocean Status Code
      • Ocean Cargo Tracking
        • Ocean Tracking Subscribe
          POST
        • Ocean Tracking Push
          POST
        • Ocean Tracking Timely Update
          POST
        • Ocean Tracking Download
          GET
    • China Port Data
      • China Port List
      • China Port Subscription
      • China Port Push
      • China Port Download
    • Container Maritime Trajectory
      • DEMO
      • Container Maritime Trajectory
  • AI Ship Prediction
    • AI Ship Prediction Query
      GET
  • Overseas Data API
    • US Terminal Data
      • US Terminal Data Subscription
      • US Terminal Data Download
    • US Customs Clearance Data
      • US Customs Clearance Data Query
  • Air Data API
    • Air Support List
    • Air Status Code
    • Air Cargo Tracking
      • Air Tracking Subscribe
      • Air Tracking Push
      • Air Tracking Download
  1. Ocean Cargo Tracking

Ocean Tracking Push

POST
https://api.trackingeyes.com

Request

Body Params application/json

Example
[
    {
        "requestId": "",
        "batchId": "20260123130000-001",
        "id": "2014252070326964224",
        "referenceNo": "6440798170",
        "referenceCtnrNo": "",
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "blNo": "6440798170",
        "bkgNo": "6440798170",
        "ctnrNo": "",
        "carrierCd": "COSCO",
        "carrier": "中远集装箱运输有限公司",
        "vesselName": "XIN SHAN TOU",
        "voyage": "220N",
        "plrCd": "CNNGB",
        "plr": "Ningbo",
        "polCd": "CNNGB",
        "pol": "Ningbo",
        "podCd": "CAPRR",
        "pod": "Prince Rupert",
        "pldCd": "USCHI",
        "pld": "Chicago",
        "cyOpenTime": "",
        "cyCutOffTime": "",
        "dlptTime": "2026-01-14 19:29:31",
        "etd": "2026-01-14 19:15:00",
        "eta": "2026-01-28 15:00:00",
        "ata": "",
        "aisATD": "2026-01-14 19:31:55",
        "aisATA": "",
        "aisETA": "2026-01-27 11:00:00",
        "firstETA": "2026-01-27 15:00:00",
        "etaPLD": "2026-02-06 08:00:00",
        "ataPLD": "",
        "dschTime": "",
        "endTrackTime": "",
        "dataUpdateTime": "2026-01-23 14:47:06",
        "endStatus": "",
        "trackStatus": "跟踪中",
        "trackStatusCd": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2026-01-22 16:21:31",
        "status": "S",
        "errorDes": "",
        "customer": "",
        "deliveryAddress": "",
        "estDelTime": "",
        "actDelTime": "",
        "custReqDate": "",
        "firstUpdateTime": "2026-01-22 16:21:51",
        "pickupreference": "",
        "railcode": "",
        "terminalPld": "",
        "terminalDtp": "Prince Rupert-Fairview Terminal",
        "serviceType": "CT",
        "blType": "BL",
        "remark": "",
        "customerUploadedData": "",
        "ctnrInfos": [
            {
                "ctnrNo": "OOCU7495448",
                "sealNo": "32516918",
                "ctnrSize": "45",
                "ctnrType": "GP",
                "pkgs": null,
                "gwgt": null,
                "vgm": null,
                "currentStatusCd": "DLPT",
                "currentStatus": "DEPARTURE FROM LOAD PORT",
                "currentStatusTime": "2026-01-14 19:29:31",
                "currentPlaceCd": "CNNGB",
                "currentPlace": "NINGBO",
                "isRolled": "",
                "ctnrStatus": [
                    {
                        "id": "2014252155911737344",
                        "statusCd": "FCGI",
                        "statusDesc": "重箱返场/入货",
                        "statusDescEn": "Laden Return",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2026-01-13 00:30:00",
                        "place": "NINGBO",
                        "placeCd": "CNNGB",
                        "transportMode": "",
                        "isEstimate": false,
                        "dateUpdateTime": "2026-01-22 16:21:50",
                        "sourceCd": "1",
                        "dataState": "update"
                    },
                    {
                        "id": "2014252155911737345",
                        "statusCd": "DLPT",
                        "statusDesc": "离港",
                        "statusDescEn": "DEPARTURE FROM LOAD PORT",
                        "vesselName": "XIN SHAN TOU",
                        "voyage": "220N",
                        "eventTime": "2026-01-14 19:29:31",
                        "place": "NINGBO",
                        "placeCd": "CNNGB",
                        "transportMode": "VESSLE",
                        "isEstimate": false,
                        "dateUpdateTime": "2026-01-22 16:21:50",
                        "sourceCd": "1",
                        "dataState": "update"
                    },
                    {
                        "id": "2014252155911737346",
                        "statusCd": "BDAR",
                        "statusDesc": "目的港抵港",
                        "statusDescEn": "BOARD ARRIVE",
                        "vesselName": "XIN SHAN TOU",
                        "voyage": "220N",
                        "eventTime": "2026-01-28 15:00:00",
                        "place": "PRINCE RUPERT",
                        "placeCd": "CAPRR",
                        "transportMode": "VESSLE",
                        "isEstimate": true,
                        "dateUpdateTime": "2026-01-23 14:46:59",
                        "sourceCd": "1",
                        "dataState": "update"
                    },
                    {
                        "id": "2014252155911737347",
                        "statusCd": "PDAR",
                        "statusDesc": "抵达交货地",
                        "statusDescEn": "PLACE OF DELIVERY ARRIVAL",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2026-02-06 08:00:00",
                        "place": "CHICAGO",
                        "placeCd": "USCHI",
                        "transportMode": "",
                        "isEstimate": true,
                        "dateUpdateTime": "2026-01-23 14:46:59",
                        "sourceCd": "1",
                        "dataState": "update"
                    }
                ],
                "deleteStatus": []
            }
        ],
        "carriges": [
            {
                "id": "2014252157467824128",
                "sno": 1,
                "polCd": "CNNGB",
                "polNameEn": "NINGBO",
                "polNameCn": "宁波",
                "podCd": "CAPRR",
                "podNameEn": "PRINCE RUPERT",
                "podNameCn": "鲁珀特王子港",
                "etd": "2026-01-14 19:30:00",
                "atd": "2026-01-14 19:29:31",
                "eta": "2026-01-28 15:00:00",
                "ata": "",
                "type": "",
                "vesselName": "XIN SHAN TOU",
                "voy": "220N",
                "aisAtd": "2026-01-14 19:31:55",
                "aisAta": "",
                "aisEta": "2026-01-27 11:00:00"
            }
        ],
        "oceanNodes": [
            {
                "stateCode": "STSP",
                "stateDesc": "Empty Pickup",
                "stateDescCN": "提空箱",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 2
            },
            {
                "stateCode": "GITM",
                "stateDesc": "FGate In to Outbound Terminal",
                "stateDescCN": "起运港进场",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 13
            },
            {
                "stateCode": "PASS",
                "stateDesc": "Customs Release",
                "stateDescCN": "海关放行",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 14
            },
            {
                "stateCode": "LOBD",
                "stateDesc": "Loaded on Board at Port of Loading",
                "stateDescCN": "装船",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 19
            },
            {
                "stateCode": "DLPT",
                "stateDesc": "Departure from Port of Loading",
                "stateDescCN": "离港",
                "place": "NINGBO",
                "placeCd": "CNNGB",
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-01-14 19:29:31",
                "aisEstimateTime": "",
                "aisActualityTime": "2026-01-14 19:31:55",
                "number": 20
            },
            {
                "stateCode": "TSBA",
                "stateDesc": "Arrived at Transhipment Port",
                "stateDescCN": "中转抵港",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 21
            },
            {
                "stateCode": "TSDP",
                "stateDesc": "Departured from Transhipment Port",
                "stateDescCN": "中转开航",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 26
            },
            {
                "stateCode": "BDAR",
                "stateDesc": "Arrived at Port of Discharge",
                "stateDescCN": "目的港抵港",
                "place": "PRINCE RUPERT",
                "placeCd": "CAPRR",
                "count": 0,
                "total": 1,
                "planTime": "2026-01-27 15:00:00",
                "estimateTime": "2026-01-28 15:00:00",
                "actualityTime": "",
                "aisEstimateTime": "2026-01-27 11:00:00",
                "aisActualityTime": "",
                "number": 27
            },
            {
                "stateCode": "DSCH",
                "stateDesc": "Discharged at Port of Discharge",
                "stateDescCN": "目的港卸船",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 28
            },
            {
                "stateCode": "PDAR",
                "stateDesc": "Arrived on Place of Delivery",
                "stateDescCN": "抵达交货地",
                "place": "CHICAGO",
                "placeCd": "USCHI",
                "count": 0,
                "total": 1,
                "planTime": "2026-02-05 08:00:00",
                "estimateTime": "2026-02-06 08:00:00",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 35
            },
            {
                "stateCode": "STCS",
                "stateDesc": "Gate Out from Inbound CY for Delivery to Consignee",
                "stateDescCN": "提重柜/提货",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 40
            },
            {
                "stateCode": "RCVE",
                "stateDesc": "Empty Container Returned",
                "stateDescCN": "还空箱",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 41
            },
            {
                "stateCode": "END",
                "stateDesc": "Tracking Finished",
                "stateDescCN": "结束跟踪",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 42
            }
        ]
    }
]

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.trackingeyes.com' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "requestId": "",
        "batchId": "20260123130000-001",
        "id": "2014252070326964224",
        "referenceNo": "6440798170",
        "referenceCtnrNo": "",
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "blNo": "6440798170",
        "bkgNo": "6440798170",
        "ctnrNo": "",
        "carrierCd": "COSCO",
        "carrier": "中远集装箱运输有限公司",
        "vesselName": "XIN SHAN TOU",
        "voyage": "220N",
        "plrCd": "CNNGB",
        "plr": "Ningbo",
        "polCd": "CNNGB",
        "pol": "Ningbo",
        "podCd": "CAPRR",
        "pod": "Prince Rupert",
        "pldCd": "USCHI",
        "pld": "Chicago",
        "cyOpenTime": "",
        "cyCutOffTime": "",
        "dlptTime": "2026-01-14 19:29:31",
        "etd": "2026-01-14 19:15:00",
        "eta": "2026-01-28 15:00:00",
        "ata": "",
        "aisATD": "2026-01-14 19:31:55",
        "aisATA": "",
        "aisETA": "2026-01-27 11:00:00",
        "firstETA": "2026-01-27 15:00:00",
        "etaPLD": "2026-02-06 08:00:00",
        "ataPLD": "",
        "dschTime": "",
        "endTrackTime": "",
        "dataUpdateTime": "2026-01-23 14:47:06",
        "endStatus": "",
        "trackStatus": "跟踪中",
        "trackStatusCd": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2026-01-22 16:21:31",
        "status": "S",
        "errorDes": "",
        "customer": "",
        "deliveryAddress": "",
        "estDelTime": "",
        "actDelTime": "",
        "custReqDate": "",
        "firstUpdateTime": "2026-01-22 16:21:51",
        "pickupreference": "",
        "railcode": "",
        "terminalPld": "",
        "terminalDtp": "Prince Rupert-Fairview Terminal",
        "serviceType": "CT",
        "blType": "BL",
        "remark": "",
        "customerUploadedData": "",
        "ctnrInfos": [
            {
                "ctnrNo": "OOCU7495448",
                "sealNo": "32516918",
                "ctnrSize": "45",
                "ctnrType": "GP",
                "pkgs": null,
                "gwgt": null,
                "vgm": null,
                "currentStatusCd": "DLPT",
                "currentStatus": "DEPARTURE FROM LOAD PORT",
                "currentStatusTime": "2026-01-14 19:29:31",
                "currentPlaceCd": "CNNGB",
                "currentPlace": "NINGBO",
                "isRolled": "",
                "ctnrStatus": [
                    {
                        "id": "2014252155911737344",
                        "statusCd": "FCGI",
                        "statusDesc": "重箱返场/入货",
                        "statusDescEn": "Laden Return",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2026-01-13 00:30:00",
                        "place": "NINGBO",
                        "placeCd": "CNNGB",
                        "transportMode": "",
                        "isEstimate": false,
                        "dateUpdateTime": "2026-01-22 16:21:50",
                        "sourceCd": "1",
                        "dataState": "update"
                    },
                    {
                        "id": "2014252155911737345",
                        "statusCd": "DLPT",
                        "statusDesc": "离港",
                        "statusDescEn": "DEPARTURE FROM LOAD PORT",
                        "vesselName": "XIN SHAN TOU",
                        "voyage": "220N",
                        "eventTime": "2026-01-14 19:29:31",
                        "place": "NINGBO",
                        "placeCd": "CNNGB",
                        "transportMode": "VESSLE",
                        "isEstimate": false,
                        "dateUpdateTime": "2026-01-22 16:21:50",
                        "sourceCd": "1",
                        "dataState": "update"
                    },
                    {
                        "id": "2014252155911737346",
                        "statusCd": "BDAR",
                        "statusDesc": "目的港抵港",
                        "statusDescEn": "BOARD ARRIVE",
                        "vesselName": "XIN SHAN TOU",
                        "voyage": "220N",
                        "eventTime": "2026-01-28 15:00:00",
                        "place": "PRINCE RUPERT",
                        "placeCd": "CAPRR",
                        "transportMode": "VESSLE",
                        "isEstimate": true,
                        "dateUpdateTime": "2026-01-23 14:46:59",
                        "sourceCd": "1",
                        "dataState": "update"
                    },
                    {
                        "id": "2014252155911737347",
                        "statusCd": "PDAR",
                        "statusDesc": "抵达交货地",
                        "statusDescEn": "PLACE OF DELIVERY ARRIVAL",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2026-02-06 08:00:00",
                        "place": "CHICAGO",
                        "placeCd": "USCHI",
                        "transportMode": "",
                        "isEstimate": true,
                        "dateUpdateTime": "2026-01-23 14:46:59",
                        "sourceCd": "1",
                        "dataState": "update"
                    }
                ],
                "deleteStatus": []
            }
        ],
        "carriges": [
            {
                "id": "2014252157467824128",
                "sno": 1,
                "polCd": "CNNGB",
                "polNameEn": "NINGBO",
                "polNameCn": "宁波",
                "podCd": "CAPRR",
                "podNameEn": "PRINCE RUPERT",
                "podNameCn": "鲁珀特王子港",
                "etd": "2026-01-14 19:30:00",
                "atd": "2026-01-14 19:29:31",
                "eta": "2026-01-28 15:00:00",
                "ata": "",
                "type": "",
                "vesselName": "XIN SHAN TOU",
                "voy": "220N",
                "aisAtd": "2026-01-14 19:31:55",
                "aisAta": "",
                "aisEta": "2026-01-27 11:00:00"
            }
        ],
        "oceanNodes": [
            {
                "stateCode": "STSP",
                "stateDesc": "Empty Pickup",
                "stateDescCN": "提空箱",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 2
            },
            {
                "stateCode": "GITM",
                "stateDesc": "FGate In to Outbound Terminal",
                "stateDescCN": "起运港进场",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 13
            },
            {
                "stateCode": "PASS",
                "stateDesc": "Customs Release",
                "stateDescCN": "海关放行",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 14
            },
            {
                "stateCode": "LOBD",
                "stateDesc": "Loaded on Board at Port of Loading",
                "stateDescCN": "装船",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 19
            },
            {
                "stateCode": "DLPT",
                "stateDesc": "Departure from Port of Loading",
                "stateDescCN": "离港",
                "place": "NINGBO",
                "placeCd": "CNNGB",
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-01-14 19:29:31",
                "aisEstimateTime": "",
                "aisActualityTime": "2026-01-14 19:31:55",
                "number": 20
            },
            {
                "stateCode": "TSBA",
                "stateDesc": "Arrived at Transhipment Port",
                "stateDescCN": "中转抵港",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 21
            },
            {
                "stateCode": "TSDP",
                "stateDesc": "Departured from Transhipment Port",
                "stateDescCN": "中转开航",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 26
            },
            {
                "stateCode": "BDAR",
                "stateDesc": "Arrived at Port of Discharge",
                "stateDescCN": "目的港抵港",
                "place": "PRINCE RUPERT",
                "placeCd": "CAPRR",
                "count": 0,
                "total": 1,
                "planTime": "2026-01-27 15:00:00",
                "estimateTime": "2026-01-28 15:00:00",
                "actualityTime": "",
                "aisEstimateTime": "2026-01-27 11:00:00",
                "aisActualityTime": "",
                "number": 27
            },
            {
                "stateCode": "DSCH",
                "stateDesc": "Discharged at Port of Discharge",
                "stateDescCN": "目的港卸船",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 28
            },
            {
                "stateCode": "PDAR",
                "stateDesc": "Arrived on Place of Delivery",
                "stateDescCN": "抵达交货地",
                "place": "CHICAGO",
                "placeCd": "USCHI",
                "count": 0,
                "total": 1,
                "planTime": "2026-02-05 08:00:00",
                "estimateTime": "2026-02-06 08:00:00",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 35
            },
            {
                "stateCode": "STCS",
                "stateDesc": "Gate Out from Inbound CY for Delivery to Consignee",
                "stateDescCN": "提重柜/提货",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 40
            },
            {
                "stateCode": "RCVE",
                "stateDesc": "Empty Container Returned",
                "stateDescCN": "还空箱",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 41
            },
            {
                "stateCode": "END",
                "stateDesc": "Tracking Finished",
                "stateDescCN": "结束跟踪",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 42
            }
        ]
    }
]'

Responses

🟢200
application/json
Body

Example
{
    "code": 200,
    "type": "S",
    "message": null,
    "time": "2023-12-13 01:20:38"
}
Modified at 2026-03-24 14:17:52
Previous
Ocean Tracking Subscribe
Next
Ocean Tracking Timely Update
Built with