- Authentication
- Global Ocean Cargo Tracking
- Global Air Cargo Tracking
Data Push Webhook
POST
Request
Body Params application/json
array of:
Id
string
optional
<= 32 characters
referenceNo
string
optional
<= 32 characters
referenceCtnrNo
string
optional
<= 12 characters
deliveryNo
string
optional
<= 12 characters
orderNo
string
optional
<= 600 characters
localKey
string
optional
<= 38 characters
blNo
string
optional
<= 128 characters
bkgNo
string
optional
<= 128 characters
ctnrNo
string
optional
<= 11 characters
carrierCd
string
optional
<= 18 characters
carrier
string
optional
<= 164 characters
vesselName
string
optional
<= 64 characters
voyage
string
optional
<= 32 characters
plrCd
string
optional
<= 8 characters
plr
string
optional
<= 164 characters
polCd
string
optional
<= 8 characters
pol
string
optional
<= 164 characters
podCd
string
optional
<= 8 characters
pod
string
optional
<= 164 characters
pldCd
string
optional
<= 8 characters
pld
string
optional
<= 164 characters
cyOpenTime
string <date-time>
optional
cyCutOffTime
string <date-time>
optional
dlptTime
string <date-time>
optional
etd
string <date-time>
optional
eta
string <date-time>
optional
ata
string <date-time>
optional
firstETA
string <date-time>
optional
etaPLD
string <date-time>
optional
ataPLD
string <date-time>
optional
dschTime
string <date-time>
optional
endTrackTime
string <date-time>
optional
dataUpdateTime
string <date-time>
optional
endStatus
string
optional
<= 20 characters
trackStatus
string
optional
<= 20 characters
trackStatusCd
string
optional
<= 20 characters
errorStatus
string
optional
<= 20 characters
errorMessage
string
optional
<= 255 characters
dataStatus
string
optional
<= 20 characters
billCreateTime
string <date-time>
optional
customer
string
optional
<= 128 characters
deliveryAddress
string
optional
<= 255 characters
estDelTime
string
optional
<= 30 characters
actDelTime
string
optional
<= 30 characters
custReqDate
string
optional
<= 30 characters
state
string
optional
B=subscription in progress, S=subscription successful, F=Subscription failed
<= 10 characters
errorDes
string
optional
<= 255 characters
ctnrInfos
array [object {15}]
optional
ctnrNo
string
optional
<= 11 characters
sealNo
string
optional
<= 18 characters
ctnrSize
string
optional
<= 3 characters
ctnrType
string
optional
<= 3 characters
pkgs
string
optional
<= 20 characters
gwgt
string
optional
<= 20 characters
vgm
string
optional
<= 20 characters
currentStatusCd
string
optional
<= 8 characters
currentStatus
string
optional
<= 255 characters
currentStatusTime
string <date-time>
optional
currentPlaceCd
string
optional
<= 8 characters
currentPlace
string
optional
<= 164 characters
isRolled
string
optional
ctnrStatus
array [object {13}]
optional
deleteStatus
array [object {13}]
optional
carriges
array [object {14}]
optional
sno
integer
optional
polCd
string
optional
<= 8 characters
polNameEn
string
optional
<= 128 characters
polNameCn
string
optional
<= 128 characters
podCd
string
optional
<= 8 characters
podNameEn
string
optional
<= 128 characters
podNameCn
string
optional
<= 128 characters
etd
string <date-time>
optional
atd
string <date-time>
optional
eta
string <date-time>
optional
ata
string <date-time>
optional
type
string
optional
<= 20 characters
vesselName
string
optional
<= 128 characters
voy
string
optional
<= 64 characters
oceanNodes
array [object {9}]
optional
stateCode
string
optional
<= 8 characters
stateDesc
string
optional
<= 255 characters
stateDescCN
string
optional
<= 255 characters
count
integer
optional
total
integer
optional
planTime
string <date-time>
optional
estimateTime
string <date-time>
optional
actualityTime
string <date-time>
optional
number
integer
optional
Example
[
{
"id": "1915644276168069120",
"referenceNo": "BMOU5314710",
"referenceCtnrNo": "",
"deliveryNo": "",
"orderNo": "",
"localKey": "",
"blNo": "",
"bkgNo": "",
"ctnrNo": "BMOU5314710",
"carrierCd": "OOCL",
"carrier": "东方海外货柜航运有限公司",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"plrCd": "CNYTN",
"plr": "Yantian,Shenzhen,Guangdong,China",
"polCd": "CNYTN",
"pol": "Yantian,Shenzhen,Guangdong,China",
"podCd": "USORF",
"pod": "Norfolk,Virginia,United States",
"pldCd": "USORF",
"pld": "Norfolk,Virginia,United States",
"cyOpenTime": "",
"cyCutOffTime": "",
"dlptTime": "2025-04-03 19:15:00",
"etd": "2025-04-03 19:15:00",
"eta": "2025-05-10 09:30:00",
"ata": "",
"firstETA": "2025-05-10 09:30:00",
"etaPLD": "2025-05-11 12:00:00",
"ataPLD": "",
"dschTime": "",
"endTrackTime": "",
"dataUpdateTime": "2025-04-27 09:00:24",
"endStatus": "",
"trackStatus": "跟踪中",
"trackStatusCd": "T",
"errorStatus": "",
"errorMessage": "",
"dataStatus": "Y",
"billCreateTime": "2025-04-25 13:49:21",
"status": "S",
"errorDes": "",
"customer": "",
"deliveryAddress": "",
"estDelTime": "",
"actDelTime": "",
"custReqDate": "",
"ctnrInfos": [
{
"ctnrNo": "BMOU5314710",
"sealNo": "",
"ctnrSize": "40",
"ctnrType": "HQ",
"pkgs": "",
"gwgt": "",
"vgm": "",
"currentStatusCd": "DLPT",
"currentStatus": "离港",
"currentStatusTime": "2025-04-03 19:15:00",
"currentPlaceCd": "CNYTN",
"currentPlace": "Yantian,Shenzhen,Guangdong,China",
"isRolled": "",
"ctnrStatus": [
{
"statusCd": "STSP",
"statusDesc": "提空箱",
"statusDescEn": "Container Picked Up(Facility)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-25 23:49:00",
"place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "",
"statusDesc": "Arrived(Port of Load)",
"statusDescEn": "Arrived(Port of Load)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-26 17:56:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "GITM",
"statusDesc": "码头进场",
"statusDescEn": "Container Received by Carrier(Origin)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-26 17:56:00",
"place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "LOBD",
"statusDesc": "装船",
"statusDescEn": "Loaded(Port of Load)",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-04-03 17:29:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "VESSEL",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "DLPT",
"statusDesc": "离港",
"statusDescEn": "DEPARTURE FROM LOAD PORT",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-04-03 19:15:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "VESSLE",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "BDAR",
"statusDesc": "目的港抵港",
"statusDescEn": "BOARD ARRIVE",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-05-10 09:30:00",
"place": "Norfolk,Virginia,United States",
"placeCd": "USORF",
"transportMode": "VESSLE",
"isEstimate": true,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": true
},
{
"statusCd": "PDAR",
"statusDesc": "抵达交货地",
"statusDescEn": "PLACE OF DELIVERY ARRIVAL",
"vesselName": "",
"voyage": "",
"eventTime": "2025-05-11 12:00:00",
"place": "Norfolk,Virginia,United States",
"placeCd": "USORF",
"transportMode": "",
"isEstimate": true,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": true
}
],
"deleteStatus": []
}
],
"carriges": [
{
"sno": 1,
"polCd": "CNYTN",
"polNameEn": "Yantian,Shenzhen,Guangdong,China",
"polNameCn": "盐田",
"podCd": "USORF",
"podNameEn": "Norfolk,Virginia,United States",
"podNameCn": "诺福克",
"etd": "2025-04-03 19:15:00",
"atd": "2025-04-03 19:15:00",
"eta": "2025-05-10 09:30:00",
"ata": "",
"type": "",
"vesselName": "CMA CGM LA TRAVIATA",
"voy": "296E"
}
],
"oceanNodes": [
{
"stateCode": "STSP",
"stateDesc": "Empty Pickup",
"stateDescCN": "提空箱",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "2025-03-25 23:49:00",
"number": 3
},
{
"stateCode": "GITM",
"stateDesc": "FGate In to Outbound Terminal",
"stateDescCN": "码头进场",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "2025-03-26 17:56:00",
"number": 12
},
{
"stateCode": "PASS",
"stateDesc": "Customs Release",
"stateDescCN": "海关放行",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 13
},
{
"stateCode": "LOBD",
"stateDesc": "Loaded on Board at Port of Loading",
"stateDescCN": "装船",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 18
},
{
"stateCode": "DLPT",
"stateDesc": "Departure from Port of Loading",
"stateDescCN": "离港",
"count": 1,
"total": 1,
"planTime": "2025-04-03 19:15:00",
"estimateTime": "2025-04-03 19:15:00",
"actualityTime": "2025-04-03 19:15:00",
"number": 19
},
{
"stateCode": "TSBA",
"stateDesc": "Arrived at Transhipment Port",
"stateDescCN": "中转抵港",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 20
},
{
"stateCode": "BDAR",
"stateDesc": "Arrived at Port of Discharge",
"stateDescCN": "目的港抵港",
"count": 0,
"total": 1,
"planTime": "2025-05-10 09:30:00",
"estimateTime": "2025-05-10 09:30:00",
"actualityTime": "",
"number": 24
},
{
"stateCode": "DSCH",
"stateDesc": "Discharged at Port of Discharge",
"stateDescCN": "目的港卸船",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 25
},
{
"stateCode": "STCS",
"stateDesc": "Gate Out from Inbound CY for Delivery to Consignee",
"stateDescCN": "提重柜/提货",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 34
},
{
"stateCode": "RCVE",
"stateDesc": "Empty Container Returned",
"stateDescCN": "还空箱",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 35
},
{
"stateCode": "END",
"stateDesc": "Tracking Finished",
"stateDescCN": "结束跟踪",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 36
}
]
}
]
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 POST 'https://api.trackingeyes.com' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"id": "1915644276168069120",
"referenceNo": "BMOU5314710",
"referenceCtnrNo": "",
"deliveryNo": "",
"orderNo": "",
"localKey": "",
"blNo": "",
"bkgNo": "",
"ctnrNo": "BMOU5314710",
"carrierCd": "OOCL",
"carrier": "东方海外货柜航运有限公司",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"plrCd": "CNYTN",
"plr": "Yantian,Shenzhen,Guangdong,China",
"polCd": "CNYTN",
"pol": "Yantian,Shenzhen,Guangdong,China",
"podCd": "USORF",
"pod": "Norfolk,Virginia,United States",
"pldCd": "USORF",
"pld": "Norfolk,Virginia,United States",
"cyOpenTime": "",
"cyCutOffTime": "",
"dlptTime": "2025-04-03 19:15:00",
"etd": "2025-04-03 19:15:00",
"eta": "2025-05-10 09:30:00",
"ata": "",
"firstETA": "2025-05-10 09:30:00",
"etaPLD": "2025-05-11 12:00:00",
"ataPLD": "",
"dschTime": "",
"endTrackTime": "",
"dataUpdateTime": "2025-04-27 09:00:24",
"endStatus": "",
"trackStatus": "跟踪中",
"trackStatusCd": "T",
"errorStatus": "",
"errorMessage": "",
"dataStatus": "Y",
"billCreateTime": "2025-04-25 13:49:21",
"status": "S",
"errorDes": "",
"customer": "",
"deliveryAddress": "",
"estDelTime": "",
"actDelTime": "",
"custReqDate": "",
"ctnrInfos": [
{
"ctnrNo": "BMOU5314710",
"sealNo": "",
"ctnrSize": "40",
"ctnrType": "HQ",
"pkgs": "",
"gwgt": "",
"vgm": "",
"currentStatusCd": "DLPT",
"currentStatus": "离港",
"currentStatusTime": "2025-04-03 19:15:00",
"currentPlaceCd": "CNYTN",
"currentPlace": "Yantian,Shenzhen,Guangdong,China",
"isRolled": "",
"ctnrStatus": [
{
"statusCd": "STSP",
"statusDesc": "提空箱",
"statusDescEn": "Container Picked Up(Facility)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-25 23:49:00",
"place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "",
"statusDesc": "Arrived(Port of Load)",
"statusDescEn": "Arrived(Port of Load)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-26 17:56:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "GITM",
"statusDesc": "码头进场",
"statusDescEn": "Container Received by Carrier(Origin)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-26 17:56:00",
"place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "LOBD",
"statusDesc": "装船",
"statusDescEn": "Loaded(Port of Load)",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-04-03 17:29:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "VESSEL",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "DLPT",
"statusDesc": "离港",
"statusDescEn": "DEPARTURE FROM LOAD PORT",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-04-03 19:15:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "VESSLE",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "BDAR",
"statusDesc": "目的港抵港",
"statusDescEn": "BOARD ARRIVE",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-05-10 09:30:00",
"place": "Norfolk,Virginia,United States",
"placeCd": "USORF",
"transportMode": "VESSLE",
"isEstimate": true,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": true
},
{
"statusCd": "PDAR",
"statusDesc": "抵达交货地",
"statusDescEn": "PLACE OF DELIVERY ARRIVAL",
"vesselName": "",
"voyage": "",
"eventTime": "2025-05-11 12:00:00",
"place": "Norfolk,Virginia,United States",
"placeCd": "USORF",
"transportMode": "",
"isEstimate": true,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": true
}
],
"deleteStatus": []
}
],
"carriges": [
{
"sno": 1,
"polCd": "CNYTN",
"polNameEn": "Yantian,Shenzhen,Guangdong,China",
"polNameCn": "盐田",
"podCd": "USORF",
"podNameEn": "Norfolk,Virginia,United States",
"podNameCn": "诺福克",
"etd": "2025-04-03 19:15:00",
"atd": "2025-04-03 19:15:00",
"eta": "2025-05-10 09:30:00",
"ata": "",
"type": "",
"vesselName": "CMA CGM LA TRAVIATA",
"voy": "296E"
}
],
"oceanNodes": [
{
"stateCode": "STSP",
"stateDesc": "Empty Pickup",
"stateDescCN": "提空箱",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "2025-03-25 23:49:00",
"number": 3
},
{
"stateCode": "GITM",
"stateDesc": "FGate In to Outbound Terminal",
"stateDescCN": "码头进场",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "2025-03-26 17:56:00",
"number": 12
},
{
"stateCode": "PASS",
"stateDesc": "Customs Release",
"stateDescCN": "海关放行",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 13
},
{
"stateCode": "LOBD",
"stateDesc": "Loaded on Board at Port of Loading",
"stateDescCN": "装船",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 18
},
{
"stateCode": "DLPT",
"stateDesc": "Departure from Port of Loading",
"stateDescCN": "离港",
"count": 1,
"total": 1,
"planTime": "2025-04-03 19:15:00",
"estimateTime": "2025-04-03 19:15:00",
"actualityTime": "2025-04-03 19:15:00",
"number": 19
},
{
"stateCode": "TSBA",
"stateDesc": "Arrived at Transhipment Port",
"stateDescCN": "中转抵港",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 20
},
{
"stateCode": "BDAR",
"stateDesc": "Arrived at Port of Discharge",
"stateDescCN": "目的港抵港",
"count": 0,
"total": 1,
"planTime": "2025-05-10 09:30:00",
"estimateTime": "2025-05-10 09:30:00",
"actualityTime": "",
"number": 24
},
{
"stateCode": "DSCH",
"stateDesc": "Discharged at Port of Discharge",
"stateDescCN": "目的港卸船",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 25
},
{
"stateCode": "STCS",
"stateDesc": "Gate Out from Inbound CY for Delivery to Consignee",
"stateDescCN": "提重柜/提货",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 34
},
{
"stateCode": "RCVE",
"stateDesc": "Empty Container Returned",
"stateDescCN": "还空箱",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 35
},
{
"stateCode": "END",
"stateDesc": "Tracking Finished",
"stateDescCN": "结束跟踪",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 36
}
]
}
]'
Responses
🟢200sucess
application/json
Body
code
integer
required
type
string
optional
message
string
optional
time
string
optional
Example
{
"code": 200,
"type": "S",
"message": null,
"time": "2023-12-13 01:20:38"
}