1. Ocean Tracking
Trackingeyes-API
🇺🇸 English
  • 🇨🇳 中文
  • 🇺🇸 English
  • First Call
  • Authentication
    • Request Signature Generation Example
    • Get Signature Token
      POST
  • Basic Information
    • Get Supported Port Codes
      GET
    • Get Supported Carrier Codes
      GET
    • Get Supported Airline Codes
      GET
  • Ocean Data API
    • Ocean Data
      • Ocean Data Support List
      • Ocean Data Status Code
      • Ocean Tracking
        • Batch Shipment Subscription API
          POST
        • Shipment Details Push API
          POST
        • Shipment On-demand Update API
          POST
        • Shipment Details Download API
          GET
        • Shipment Exception Alert Push API
          POST
      • On-demand Request
        • Batch On-demand Request API
        • On-demand Request Push API
    • China Terminal Data
      • China Terminal Data Support List
      • China Terminal Data Subscription API
      • China Terminal Data Details Push API
      • China Terminal Data Details Download API
    • Container Visual Tracking
      • Iframe Embedding Documentation
      • Container Visual Tracking API
    • China Vessel Call Plan
      • China Vessel Call Plan Data Support List
      • China Vessel Call Plan Query API
  • Air Data API
    • Air Tracking
      • Air Data Support List
      • Air Data Status Code
      • Batch Shipment Subscription API
      • Shipment Details Push API
      • Batch Shipment Details Download API
  • Multimodal Transport API
    • Multimodal Transport API Guide
    • Logistics Order Upload API
      POST
    • Segment Shipment Subscription API
      POST
    • Segment Shipment Ownership Update API
      POST
    • Manual Shipment Status Upload API
      POST
    • Logistics Order Event Push API
      POST
    • Logistics Order Tracking Download API
      GET
    • Multimodal Transport Exception Alert Push API
      POST
  • Al Vessel Prediction API
    • AI Iframe Embedding Documentation
    • Single Vessel Query API
    • Current Status API
    • Port Call Prediction API
    • Vessel Track API
    • Global Port Congestion Query API
  • Schedule API
    • Port to Port Schedule
      • Carrier Support List
      • Origin Port Support List
      • Iframe Embedding Documentation
      • Port to Port Schedule Query API
      • Port to Port Schedule Paged Push API
    • Vessel Schedule
      • Carrier Support List
      • Vessel Schedule Query API
      • Vessel Schedule Push API
  • Overseas Data API
    • Global Terminal Data
      • Global Terminal Data Support List
      • Global Terminal Data Subscription API
      • Global Terminal Data Push API
      • Global Terminal Data Download API
    • US Customs Clearance Data
      • US Customs Clearance Data Carrier List
      • US Customs Clearance Data Support List
      • US Customs Clearance Data Subscription API
      • US Customs Clearance Data Push API
      • US Customs Clearance Data Query API
      • US Customs Clearance On-demand Update API
      • In Bond Query API
  • Global Express Tracking Data API
    • Global Express Tracking Data Sluggroup List
    • Global Express Data Subscription API
    • Global Express Data Push API
    • Global Express Data Download API
  • China Inland Data API
    • China Equipment Interchange Receipt
      • EIR Query API
    • Qingdao Depot Data
      • Qingdao Depot Data Support List
      • Qingdao Depot Data Push API
      • Qingdao Depot Data Subscription API
      • Qingdao Depot Data Download API
    • China Container Truck GPS
      • China Container Truck Positioning API
      • China Container Truck Trajectory API
      • China Container Truck Route Planning API
  • China Customs Data API
    • Customs Declaration Data
      • Customs Declaration Data Subscription API
      • Customs Declaration Data Push API
      • Customs Declaration Data Download API
    • Manifest Data
      • Manifest Data Subscription API
      • Manifest Data Push API
      • Manifest Data Download API
  1. Ocean Tracking

Shipment Details Download API

GET
https://api.trackingeyes.com/api/oceanbill/oceanBill
1.
Only a single shipment can be downloaded; batch download is not supported.
2.
Call frequency limit: 60 times per minute.

Request

Query Params

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 'https://api.trackingeyes.com/api/oceanbill/oceanBill?companyCode=&token=&billId=&orgCode='

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": {
        "id": "2047136085763059712",
        "referenceNo": "YMMU6658784",
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "blNo": "",
        "bkgNo": "",
        "ctnrNo": "",
        "carrierCd": "YML",
        "carrier": "阳明海运股份有限公司",
        "vesselName": "YM TRIUMPH",
        "voyage": "028E",
        "plrCd": "ILASH",
        "plr": "ASHDOD - ISRAEL PORTS AUTHORITY",
        "polCd": "ILASH",
        "pol": "ASHDOD - ISRAEL PORTS AUTHORITY",
        "podCd": "",
        "pod": "",
        "pldCd": "",
        "pld": "",
        "cyOpenTime": "",
        "cyCutOffTime": "",
        "dlptTime": "2026-03-02 11:03:01",
        "etd": "2026-03-02 11:03:00",
        "eta": "",
        "ata": "",
        "aisATD": "2026-03-01 06:05:24",
        "aisATA": "",
        "aisETA": "",
        "firstETA": "",
        "etaPld": "",
        "ataPld": "",
        "dschTime": "",
        "endTrackTime": "",
        "firstUpdateTime": "2026-04-23 16:00:46",
        "dataUpdateTime": "2026-04-27 06:02:31",
        "endStatus": "",
        "trackStatus": "跟踪中",
        "trackStatusCd": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2026-04-23 10:10:51",
        "status": "S",
        "errorDes": "",
        "customer": "",
        "deliveryAddress": "",
        "estDelTime": "",
        "actDelTime": "",
        "custReqDate": "",
        "pickupreference": "",
        "railcode": "",
        "terminalPld": "",
        "terminalDtp": "",
        "serviceType": "C",
        "customerUploadedData": "{\"clearanceStatus\":\"\",\"blReturned\":\"\",\"cargoPhotoProvided\":\"\"}",
        "shipRolled": "",
        "orgCode": "",
        "oldVesselName": "",
        "oldVoyage": "",
        "ctnrInfos": [
            {
                "ctnrNo": "YMMU6658784",
                "sealNo": "",
                "ctnrSize": "40",
                "ctnrType": "HQ",
                "pkgs": "",
                "gwgt": "",
                "vgm": "",
                "currentStatusCd": "DLPT",
                "currentStatus": "DEPARTURE FROM LOAD PORT",
                "currentStatusTime": "2026-03-02 11:03:01",
                "currentPlaceCd": "ILASH",
                "currentPlace": "ASHDOD - ISRAEL PORTS AUTHORITY",
                "isRolled": "",
                "chargeDatas": [
                    {
                        "chargeType": "PODDemurrage",
                        "lfd": "",
                        "freeDayDesc": "1 Working Days"
                    },
                    {
                        "chargeType": "PODDetention",
                        "lfd": "",
                        "freeDayDesc": "10 Working Days"
                    }
                ],
                "ctnrStatus": [
                    {
                        "id": "2047224146125025284",
                        "statusCd": "DLPT",
                        "statusDesc": "离港",
                        "statusDescEn": "DEPARTURE FROM LOAD PORT",
                        "vesselName": "YM TRIUMPH",
                        "voyage": "028E",
                        "eventTime": "2026-03-02 11:03:01",
                        "place": "ASHDOD - ISRAEL PORTS AUTHORITY",
                        "placeCd": "ILASH",
                        "transportMode": "VESSEL",
                        "dateUpdateTime": "2026-04-23 16:00:46",
                        "sourceCd": "4",
                        "isEstimate": false
                    },
                    {
                        "id": "2047224146125025283",
                        "statusCd": "LOBD",
                        "statusDesc": "装船",
                        "statusDescEn": "On Board",
                        "vesselName": "YM TRIUMPH",
                        "voyage": "028E",
                        "eventTime": "2026-03-02 11:03:00",
                        "place": "ASHDOD - ISRAEL PORTS AUTHORITY",
                        "placeCd": "ILASH",
                        "transportMode": "VESSEL",
                        "dateUpdateTime": "2026-04-23 16:00:46",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "id": "2047224146125025281",
                        "statusCd": "FCGI",
                        "statusDesc": "重箱返场/入货",
                        "statusDescEn": "Cargo Received from Yard",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2026-02-25 10:53:00",
                        "place": "ASHDOD - ISRAEL PORTS AUTHORITY",
                        "placeCd": "ILASH",
                        "transportMode": "",
                        "dateUpdateTime": "2026-04-23 16:00:46",
                        "sourceCd": "4",
                        "isEstimate": false
                    },
                    {
                        "id": "2047224146125025282",
                        "statusCd": "GITM",
                        "statusDesc": "起运港进场",
                        "statusDescEn": "Received at Origin",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2026-02-25 10:53:00",
                        "place": "ASHDOD - ISRAEL PORTS AUTHORITY",
                        "placeCd": "ILASH",
                        "transportMode": "",
                        "dateUpdateTime": "2026-04-23 16:00:46",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "id": "2047224146125025280",
                        "statusCd": "STSP",
                        "statusDesc": "提空箱",
                        "statusDescEn": "Empty to Shipper",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2026-02-24 16:54:00",
                        "place": "HAIFA - NEPTUNE P&A LTD",
                        "placeCd": "ILHFA",
                        "transportMode": "",
                        "dateUpdateTime": "2026-04-23 16:00:46",
                        "sourceCd": "1",
                        "isEstimate": false
                    }
                ]
            }
        ],
        "carriges": [
            {
                "id": "2047224147433648128",
                "sno": 1,
                "polCd": "ILASH",
                "polNameEn": "ASHDOD - ISRAEL PORTS AUTHORITY",
                "polNameCn": "阿什杜德",
                "podCd": "",
                "podNameEn": "",
                "podNameCn": "",
                "etd": "2026-03-02 11:03:00",
                "atd": "2026-03-02 11:03:01",
                "eta": "",
                "ata": "",
                "vesselName": "YM TRIUMPH",
                "voy": "028E",
                "type": "1",
                "aisAtd": "2026-03-01 06:05:24",
                "aisAta": "",
                "aisEta": ""
            }
        ],
        "oceanNodes": [
            {
                "stateCode": "STSP",
                "stateDesc": "Empty Pickup",
                "stateDescCN": "提空箱",
                "place": "HAIFA - NEPTUNE P&A LTD",
                "placeCd": "ILHFA",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-02-24 16:54:00",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 2
            },
            {
                "stateCode": "GITM",
                "stateDesc": "FGate In to Outbound Terminal",
                "stateDescCN": "起运港进场",
                "place": "ASHDOD - ISRAEL PORTS AUTHORITY",
                "placeCd": "ILASH",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-02-25 10:53:00",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 13
            },
            {
                "stateCode": "PASS",
                "stateDesc": "Customs Release",
                "stateDescCN": "海关放行",
                "place": "",
                "placeCd": "",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 14
            },
            {
                "stateCode": "LOBD",
                "stateDesc": "Loaded on Board at Port of Loading",
                "stateDescCN": "装船",
                "place": "ASHDOD - ISRAEL PORTS AUTHORITY",
                "placeCd": "ILASH",
                "vesselName": "YM TRIUMPH",
                "voy": "028E",
                "isCurrent": false,
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-03-02 11:03:00",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 19
            },
            {
                "stateCode": "DLPT",
                "stateDesc": "Departure from Port of Loading",
                "stateDescCN": "离港",
                "place": "ASHDOD - ISRAEL PORTS AUTHORITY",
                "placeCd": "ILASH",
                "vesselName": "YM TRIUMPH",
                "voy": "028E",
                "isCurrent": true,
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-03-02 11:03:01",
                "aisEstimateTime": "",
                "aisActualityTime": "2026-03-01 06:05:24",
                "number": 20
            },
            {
                "stateCode": "TSBA",
                "stateDesc": "Arrived at Transhipment Port",
                "stateDescCN": "中转抵港",
                "place": "",
                "placeCd": "",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 21
            },
            {
                "stateCode": "TSDP",
                "stateDesc": "Departured from Transhipment Port",
                "stateDescCN": "中转开航",
                "place": "",
                "placeCd": "",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 26
            },
            {
                "stateCode": "BDAR",
                "stateDesc": "Arrived at Port of Discharge",
                "stateDescCN": "目的港抵港",
                "place": "",
                "placeCd": "",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 27
            },
            {
                "stateCode": "DSCH",
                "stateDesc": "Discharged at Port of Discharge",
                "stateDescCN": "目的港卸船",
                "place": "",
                "placeCd": "",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 28
            },
            {
                "stateCode": "PDAR",
                "stateDesc": "Arrived on Place of Delivery",
                "stateDescCN": "抵达交货地",
                "place": "",
                "placeCd": "",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 35
            },
            {
                "stateCode": "STCS",
                "stateDesc": "Gate Out from Inbound CY for Delivery to Consignee",
                "stateDescCN": "提重柜/提货",
                "place": "",
                "placeCd": "",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 40
            },
            {
                "stateCode": "RCVE",
                "stateDesc": "Empty Container Returned",
                "stateDescCN": "还空箱",
                "place": "",
                "placeCd": "",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 41
            },
            {
                "stateCode": "END",
                "stateDesc": "Tracking Finished",
                "stateDescCN": "结束跟踪",
                "place": "",
                "placeCd": "",
                "vesselName": "",
                "voy": "",
                "isCurrent": false,
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 42
            }
        ]
    }
}
Modified at 2026-10-18 08:21:21
Previous
Shipment On-demand Update API
Next
Shipment Exception Alert Push API
Built with