Get air cargo trackings
# Endpoint
POST https://api.track123.com/gateway/open-api/tk/v1/aviation/track/query
# Interface description
You can track up to 100 tracking numbers at a time.
# Request parameter
Name | Description | Required | Type |
---|---|---|---|
trackingNo | Tracking number | true | string |
# Request example
[
{
"carrierCode": "atlasair",
"trackingNo": "369-84941043"
},
{
"carrierCode": "atlasair",
"trackingNo": "369-987654321"
},
{
"carrierCode": "atlasair",
"trackingNo": "369-123"
}
]
# 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 |
aviationTransitStatus | The tracking status of the shipment | string |
weight | Cargo weight | number |
piece | Number of cargos | integer |
timeZone | The timezone of the trakcing details | string |
origin | The origin station the cargo is sent from | String |
destination | The destination station the cargo is sent to | 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 |
flightInfo | The flight information | array[object] |
ata | Actual depart time | string |
atd | Actual depart time in UTC | string |
eta | Estimate depart time | string |
etd | Estimate depart time in UTC | string |
flightNo | Flight number | string |
shipFrom | The location where the flight shipping from | string |
shipTo | The location where the flight shipping to | string |
trackDetails | Detailed list of tracks, in reverse chronological order | array[object] |
status | The status of the tracking details (based on Track123) | string |
originStatus | The status of the trakcing details (based on the carrier) | string |
event | Tracking event | string |
eventTime | Tracking event time | string |
actualTime | Tracking event actual time | string |
planTime | Tracking event plan time | string |
flightNo | Flight number of the event | string |
weight | Cargo weight of the event | number |
piece | Number of cargo of the event | integer |
station | The station of the event | string |
rejected | Rejected registration of tracking number | array[object] |
trackingNo | Tracking number | String |
error | Error | object |
code | Error code | String |
msg | Error infomation | String |
# Response example
{
"code": "00000",
"data": {
"accepted": [
{
"trackingNo": "369-84941043",
"origin": "HKG",
"destination": "GRU",
"piece": 13,
"weight": 288,
"timeZone": "UTC+00:00",
"aviationTransitStatus": "EXPIRED",
"carrierInfo": {
"carrierCode": "atlasair",
"carrierNameCN": "美国阿特拉斯航空公司",
"carrierNameEN": "Atlas Air",
"carrierHomePage": "https://www.atlasair.com/"
},
"flightInfo": [
{
"flightNo": "5Y8052",
"shipFrom": "HKG",
"shipTo": "GRU",
"atd": "2022-08-27 04:30:00"
}
],
"trackDetails": [
{
"status": "RCF",
"originStatus": "RCS",
"actualTime": "2022-08-27 05:58:00",
"eventTime": "2022-08-27 05:58:00",
"event": "Received Cargo from Shipper",
"station": "HKG",
"flightNo": "",
"piece": 13,
"weight": 1
},
{
"status": "DEP",
"originStatus": "DEP",
"actualTime": "2022-08-27 04:30:00",
"eventTime": "2022-08-27 04:30:00",
"event": "Departed Flight",
"station": "HKG",
"flightNo": "5Y8052",
"piece": 13,
"weight": 288
},
{
"status": "DEP",
"originStatus": "DEP",
"actualTime": "2022-08-27 04:30:00",
"eventTime": "2022-08-27 04:30:00",
"event": "Departed Flight",
"station": "HKG",
"flightNo": "5Y8052",
"piece": 13,
"weight": 288
}
]
},
{
"trackingNo": "369-987654321",
"piece": 0,
"weight": 0,
"timeZone": "UTC+00:00",
"aviationTransitStatus": "NO_RECORD",
"carrierInfo": {
"carrierCode": "atlasair",
"carrierNameCN": "美国阿特拉斯航空公司",
"carrierNameEN": "Atlas Air",
"carrierHomePage": "https://www.atlasair.com/"
}
}
],
"rejected": [
{
"trackingNo": "369-123",
"error": {
"msg": "该运单尚未注册",
"code": "A0400"
}
}
]
},
"msg": "成功",
"traceId": "6058fd26a116449899a3b98c6a52547a.147.16709342450670653"
}