TrackingEyes-API
  1. Global Ocean Cargo Tracking
TrackingEyes-API
  • Authentication
    • OAuth
      POST
  • Global Ocean Cargo Tracking
    • Ocean Status Code
    • Ocean Support List
    • Bulk Ocean Tracking Subscribe
      POST
    • Ocean Tracking Push
      POST
    • Ocean Tracking download
      GET
  • Global Air Cargo Tracking
    • Air Status Code
    • Air Support List
    • Bulk Air Tracking Subscribe
      POST
    • Air Tracking Push
      POST
    • Bulk Air Tracking Download
      GET
  1. Global Ocean Cargo Tracking

Ocean Tracking download

Developing
GET
/api/oceanbill/oceanBill
1.
The interface only retrieves the details of a single waybill.
2.
Call Frequency Limit: 60 times per minute.

Request

Query Params
companyCode
string 
required
Enterprise ID
token
string 
required
Encrypted signature token
orgCode
string 
optional
Organization code
billId
string 
required
The ID returned by the Subscription interface

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

Responses

🟢200成功
application/json
Body
code
integer 
required
Status code(200=success，other=fail)
codeDesc
string 
required
Status description
<= 8 characters
message
string 
required
Abnormal information
<= 255 characters
result
object 
required
id
string 
required
The ID returned by the Subscription interface
<= 32 characters
referenceNo
string 
optional
Subscription Number
<= 32 characters
deliveryNo
string 
optional
Delivery note number
<= 38 characters
orderNo
string 
optional
Order number
<= 600 characters
localKey
string 
optional
Customer Local Keywords
<= 38 characters
blNo
string 
optional
Bill of Lading number
<= 128 characters
bkgNo
string 
optional
Booking number
<= 128 characters
ctnrNo
string 
optional
Container number
<= 11 characters
carrierCd
string 
optional
Trackingeyes Shipowner Code
<= 18 characters
carrier
string 
optional
Shipowner abbreviation
<= 164 characters
vesselName
string 
optional
Port of departure vessel name
<= 64 characters
voyage
string 
optional
Port of departure voyage
<= 32 characters
plrCd
string 
optional
Place of Receipt code
<= 8 characters
plr
string 
optional
Place of Receipt
<= 164 characters
polCd
string 
optional
Port of Loading code
<= 8 characters
pol
string 
optional
Port of Loading
<= 164 characters
podCd
string 
optional
Port of Discharge Code
<= 8 characters
pod
string 
optional
Port of Discharge
<= 164 characters
pldCd
string 
optional
Place of Delivery code
<= 8 characters
pld
string 
optional
Place of Delivery
<= 164 characters
cyOpenTime
string <date-time>
optional
Port opening time
cyCutOffTime
string <date-time>
optional
Port closing time
dlptTime
string <date-time>
optional
Actual departure time
etd
string <date-time>
optional
Expected departure time from the port of departure
eta
string <date-time>
optional
Estimated time of arrival at the destination port
ata
string <date-time>
optional
Actual time of arrival at port of destination
firstETA
string <date-time>
optional
The first estimated time of arrival obtained after departure
etaPld
string <date-time>
optional
Estimated arrival time of delivery
ataPld
string <date-time>
optional
Actual arrival time of delivery
dschTime
string <date-time>
optional
Unloading time
endTrackTime
string <date-time>
optional
End time
firstUpdateTime
string <date-time>
optional
First data update time
dataUpdateTime
string <date-time>
optional
Data update time
endStatus
string 
optional
End state(null value=not ended, E=normal end, EF=forced end)
<= 20 characters
trackStatus
string 
optional
Chinese description of tracking status
<= 20 characters
trackStatusCd
string 
optional
Tracking status(T=Tracking in progress, E=Tracking ended, F=Tracking failed)
<= 20 characters
errorStatus
string 
optional
Abnormal state(T=prompt, E=error, null value)
<= 20 characters
errorMessage
string 
optional
<= 255 characters
dataStatus
string 
optional
Data status(Y=with data, B=shipowner without data, F=data acquisition failed, null value)
<= 20 characters
billCreateTime
string <date-time>
optional
Subscription time
status
string 
optional
Subscription Status(B=subscription in progress, S=subscription successful, F=Subscription failed)
<= 10 characters
errorDes
string 
optional
Subscription failure information
<= 255 characters
ctnrInfos
array [object {14}] 
required
Container Information Array
carriges
array [object {14}] 
optional
Voyage information Array
Example
{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": {
        "id": "1915229213674311680",
        "referenceNo": "025F605301",
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "blNo": "025F605301",
        "bkgNo": "",
        "ctnrNo": "WHSU5390850",
        "carrierCd": "WHL",
        "carrier": "万海航运有限公司",
        "vesselName": "WAN HAI 328",
        "voyage": "S050",
        "plrCd": "CNSHK",
        "plr": "SHEKOU (CN)",
        "polCd": "CNSHK",
        "pol": "SHEKOU (CN)",
        "podCd": "MYLPK",
        "pod": "PORT KLANG NORTH PORT (MY)",
        "pldCd": "MYLPK",
        "pld": "PORT KLANG NORTH PORT (MY)",
        "cyOpenTime": "",
        "cyCutOffTime": "",
        "dlptTime": "2025-04-28 00:48:01",
        "etd": "2025-04-28 00:00:00",
        "eta": "2025-05-02 00:00:00",
        "ata": "2025-05-02 20:37:59",
        "firstETA": "2025-05-01 00:00:00",
        "etaPld": "2025-05-02 00:00:00",
        "ataPld": "2025-05-02 20:37:59",
        "dschTime": "2025-05-02 20:37:59",
        "endTrackTime": "2025-05-06 14:24:46",
        "firstUpdateTime": "2025-04-24 10:23:22",
        "dataUpdateTime": "2025-05-07 14:50:13",
        "endStatus": "E",
        "trackStatus": "跟踪结束",
        "trackStatusCd": "E",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2025-04-24 10:20:05",
        "status": "S",
        "errorDes": "",
        "ctnrInfos": [
            {
                "ctnrNo": "WHSU5390850",
                "sealNo": "",
                "ctnrSize": "40",
                "ctnrType": "HQ",
                "pkgs": "",
                "gwgt": "",
                "vgm": "",
                "currentStatusCd": "RCVE",
                "currentStatus": "还空箱",
                "currentStatusTime": "2025-05-06 10:34:00",
                "currentPlaceCd": "MYLPK",
                "currentPlace": "Yi Chun Odd",
                "isRolled": "",
                "ctnrStatus": [
                    {
                        "statusCd": "RCVE",
                        "statusDesc": "还空箱",
                        "statusDescEn": "Empty Container Discharged From Vessel Or Gate In To Pier/Terminal/Off-Dock Depot (Empty Available)",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2025-05-06 10:34:00",
                        "place": "Yi Chun Odd",
                        "placeCd": "MYLPK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "STCS",
                        "statusDesc": "提重柜/提货",
                        "statusDescEn": "Full Container Withdrawn By Consignee From Pier/Terminal",
                        "vesselName": "WAN HAI 328",
                        "voyage": "N050",
                        "eventTime": "2025-05-04 12:27:00",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "DSCH",
                        "statusDesc": "目的港卸船",
                        "statusDescEn": "Full Container(Fcl) Discharged From Vessel Or Gate In To Pier/Terminal",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-05-02 20:38:00",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "PDDS",
                        "statusDesc": "交货地卸箱",
                        "statusDescEn": "Full Container(Fcl) Discharged From Vessel Or Gate In To Pier/Terminal",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-05-02 20:38:00",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "PDAR",
                        "statusDesc": "抵达交货地",
                        "statusDescEn": "PLACE OF DELIVERY ARRIVAL",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-05-02 20:37:59",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "VESSLE",
                        "sourceCd": "4",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "BDAR",
                        "statusDesc": "目的港抵港",
                        "statusDescEn": "BOARD ARRIVE",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-05-02 20:37:59",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "VESSLE",
                        "sourceCd": "4",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "DLPT",
                        "statusDesc": "离港",
                        "statusDescEn": "DEPARTURE FROM LOAD PORT",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-04-28 00:48:01",
                        "place": "SHEKOU (CN)",
                        "placeCd": "CNSHK",
                        "transportMode": "VESSLE",
                        "sourceCd": "4",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "LOBD",
                        "statusDesc": "装船",
                        "statusDescEn": "Laden Ctnr Loaded On Board Vessel.(Mother Vessel,Fixed Slot Charter/Joint Venture Vessel)",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-04-28 00:48:00",
                        "place": "Sku01",
                        "placeCd": "CNSHK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "GITM",
                        "statusDesc": "码头进场",
                        "statusDescEn": "Outbound Full Container Gate In To Peir/Terminal(Fcl)",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-04-23 20:43:00",
                        "place": "Sku01",
                        "placeCd": "CNSHK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "STSP",
                        "statusDesc": "提空箱",
                        "statusDescEn": "Empty Container Released To Shipper From Pier/Terminal/Off-Dock Depot",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2025-04-22 23:14:00",
                        "place": "Sku01",
                        "placeCd": "CNSHK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    }
                ]
            }
        ],
        "carriges": [
            {
                "sno": 1,
                "polCd": "CNSHK",
                "polNameEn": "SHEKOU (CN)",
                "polNameCn": "蛇口",
                "podCd": "MYLPK",
                "podNameEn": "Port Klang North Port - Ct1",
                "podNameCn": "巴生北港",
                "etd": "2025-04-28 00:00:00",
                "atd": "2025-04-28 00:48:01",
                "eta": "2025-05-02 00:00:00",
                "ata": "2025-05-02 20:37:59",
                "vesselName": "WAN HAI 328",
                "voy": "S050",
                "type": ""
            }
        ]
    }
}
Modified at 2025-06-12 13:50:33
Previous
Ocean Tracking Push
Next
Air Status Code
Built with