Get ocean cargo trackings
# Endpoint
POST https://api.track123.com/gateway/open-api/tk/v1/ocean/track/query
# Interface description
You can track up to 100 tracking numbers at a time.
# Request parameter
Name | Description | Required | Type |
---|---|---|---|
orderNo | The unique order number generated by Track123 when a tracking number is registered | true | String |
trackingNo | Tracking number | true | string |
type | Tracking number type (1. booking number 2. bill of landing number 3. container number) | true | integer |
# Request example
[
{
"trackingNo": "MATS5217756000",
"type": 2,
"orderNo": "11111111"
},
{
"trackingNo": "MATS5217756002",
"type": 2,
"orderNo": "11111112"
}
]
# Response parameter
Name | Description | Type |
---|---|---|
code | Service status code | string |
msg | The description information corresponding to the service status code or other auxiliary description information. | string |
data | Object actually returned | object |
accepted | Successful registration of tracking number | array[object] |
id | Major key | String |
trackingNo | Tracking number | String |
type | Tracking number type (1. booking number 2. bill of landing number 3. container number) | number |
searchStatus | The search status of the tracking number | String |
createTime | Create time | string |
customerEmail | The customer email address associated with the order filled in by the merchant/platform | string |
orderNo | The unique order number generated by Track123 when a tracking number is registered | string |
carrierInfo | The carrier information | object |
carrierCode | The unique carrier code | string |
carrierHomePage | Carrier website home page | string |
carrierNameCN | Carrier name in Chinese | string |
carrierNameEN | Carrier name in English | string |
containerInfo | The container information | array[object] |
containerNo | Container number | string |
containerSize | Container size | string |
containerType | Container type | string |
currentStatus | The container's current shipping status | object |
eventDetails | The description of the latest tracking details | string |
eventTime | The time of the event | string |
eventTimeUTC | The time of the event in UTC | string |
locationName | The location of the event | string |
locationType | Location type | string |
transitStatus | Transit status | string |
transitSubStatus | Transit sub-status | string |
vesselName | Vessel name | string |
voyage | Voyage | string |
receipt | The cargo receipt place information | object |
locationName | Location name | string |
estimateDepartTime | Estimate depart time | string |
estimateDepartTimeUTC | Estimate depart time in UTC | string |
departTime | Actual depart time | string |
departTimeUTC | Actual depart time in UTC | string |
delivery | The cargo delivery place information | object |
locationName | Location name | string |
estimateArriveTime | Estimate arrive tim | string |
estimateArriveTimeUTC | Estimate arrive time in UT | string |
arriverTime | Actual arrive time | string |
arriverTimeUTC | Actual arrive time in UTC | string |
lastTrackingTime | Time of the last tracking information | string |
nextUpdateTime | The next update time of a tracking number, if it is null, this tracking number will not update again | string |
trackingDetails | Detailed list of tracks, in reverse chronological order | array[object] |
eventDetails | The description of the latest tracking details | string |
eventStatus | The status of the tracking detail | string |
eventTime | The time of the event | string |
eventTimeUTC | The time of the event in UTC | string |
locationName | The location of the event | string |
locationType | Location type | string |
transitStatus | Transit status | string |
transitSubStatus | Transit sub-status | string |
vesselName | Vessel name | string |
voyage | Voyage | string |
rejected | Rejected registration of tracking number | array[object] |
carrierCode | The unique carrier code | String |
orderNo | The unique order number generated by Track123 when a tracking number is registered | String |
trackingNo | Tracking number | String |
type | Tracking number type (1. booking number 2. bill of landing number 3. container number) | integer |
error | Error | object |
code | Error code | String |
msg | Error infomation | String |
# Response example
{
"code": "00000",
"data": {
"accepted": [
{
"trackingNo": "MATS5217756000",
"type": 2,
"searchStatus": "SUCCESS_FINAL",
"orderNo": "11111111",
"createTime": "2022-12-13 20:07:58",
"customerEmail": "lvsupport@track123.com",
"carrierInfo": {
"carrierCode": "matson",
"carrierNameCN": "Matson",
"carrierNameEN": "Matson",
"carrierHomePage": "https://www.matson.com/shipment-tracking.html"
},
"containerInfo": [
{
"containerNo": "MATU272542",
"containerType": "Dry Container 40' Hi-cube",
"containerSize": "Dry Container 40' Hi-cube",
"containerDetails": "Dry Container 40' Hi-cube",
"lastTrackingTime": "2022-09-28 09:03:00",
"receipt": {
"locationName": "LONG BEACH",
"arriverTime": "2022-09-19 00:00:00"
},
"delivery": {
"locationName": "SHANGHAI"
},
"transitStatus": "DELIVERED",
"currentStatus": {
"eventDetails": "RETURNED FROM CONSIGNEE",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-28 09:03:00",
"eventTimeUTC": "2022-09-29 01:03:00",
"locationName": "LONG BEACH (CA)"
},
"trackingDetails": [
{
"eventDetails": "RETURNED FROM CONSIGNEE",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-28 09:03:00",
"eventTimeUTC": "2022-09-29 01:03:00",
"locationName": "LONG BEACH (CA)"
},
{
"eventDetails": "OUTGATE to HONG ANDA LOGISTICS INC",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-22 08:59:00",
"eventTimeUTC": "2022-09-23 00:59:00",
"locationName": "SHIPPERS TRANSPORT ALAMEDA (CA)"
},
{
"eventDetails": "AVAILABLE",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-21 13:42:01",
"eventTimeUTC": "2022-09-22 05:42:01",
"locationName": "SHIPPERS TRANSPORT ALAMEDA (CA)"
},
{
"eventDetails": "HOLD RELEASED - Customs Clearance",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-21 13:42:00",
"eventTimeUTC": "2022-09-22 05:42:00",
"locationName": ""
},
{
"eventDetails": "INGATE Full by SHIPPERS TRANSPORT EXPRESS",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-20 23:24:00",
"eventTimeUTC": "2022-09-21 15:24:00",
"locationName": "SHIPPERS TRANSPORT ALAMEDA (CA)"
},
{
"eventDetails": "OUTGATE to SHIPPERS TRANSPORT EXPRESS",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-20 23:08:00",
"eventTimeUTC": "2022-09-21 15:08:00",
"locationName": "LONG BEACH (CA)"
},
{
"eventDetails": "DISCHARGE FROM VESSEL MANUKAI 229",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-20 07:38:00",
"eventTimeUTC": "2022-09-20 23:38:00",
"locationName": "LONG BEACH (CA)"
},
{
"eventDetails": "HOLD RELEASED - Order Bill of Lading",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-15 01:23:00",
"eventTimeUTC": "2022-09-15 17:23:00",
"locationName": ""
},
{
"eventDetails": "HOLD RELEASED - Hold for Payment",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-14 07:37:00",
"eventTimeUTC": "2022-09-14 23:37:00",
"locationName": ""
},
{
"eventDetails": "CONTAINER ON HOLD - Hold for Payment",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-09 21:56:00",
"eventTimeUTC": "2022-09-10 13:56:00",
"locationName": ""
},
{
"eventDetails": "CONTAINER ON HOLD - Order Bill of Lading",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-09 21:56:00",
"eventTimeUTC": "2022-09-10 13:56:00",
"locationName": ""
},
{
"eventDetails": "LOAD TO VESSEL MANUKAI 229",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-09 10:30:00",
"eventTimeUTC": "2022-09-10 02:30:00",
"locationName": "SHANGHAI"
},
{
"eventDetails": "CONTAINER ON HOLD - Customs Clearance",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-09 02:02:00",
"eventTimeUTC": "2022-09-09 18:02:00",
"locationName": ""
},
{
"eventDetails": "INGATE Full by SHANGHAI",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-06 06:39:00",
"eventTimeUTC": "2022-09-06 22:39:00",
"locationName": "SHANGHAI"
}
]
}
]
}
],
"rejected": [
{
"trackingNo": "MATS5217756002",
"type": 2,
"orderNo": "11111112",
"error": {
"msg": "该运单尚未注册",
"code": "A0400"
}
}
]
},
"msg": "成功",
"traceId": "6058fd26a116449899a3b98c6a52547a.151.16709335122540597"
}