TrackingEyes-API
  1. Global Air 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 Air Cargo Tracking

Bulk Air Tracking Download

GET
/api/airLinesBill/download
1.Maximum waybill quantity per bulk download is 30.
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,multiple billIds should be separated by English commas,without any blank space
Example:
1912707297906397184,1912077293728174080

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/airLinesBill/download?companyCode&token&orgCode&billId=1912707297906397184,1912077293728174080'

Responses

🟢200成功
application/json
Body
code
integer 
required
Status code(200=success,other=fail)
codeDesc
string 
required
Status description
<= 255 characters
message
string 
required
Abnormal information
<= 255 characters
result
array [object {41}] 
required
id
string 
optional
The ID returned by the Subscription interface
<= 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
orgCode
string 
optional
Order number
<= 64 characters
customer
string 
optional
Customer
<= 128 characters
awbNo
string 
optional
Air waybill number
<= 32 characters
referenceNo
string 
optional
Subscription number (AWB Number)
<= 32 characters
carrierCd
string 
optional
IATA Code
<= 16 characters
carrier
string 
optional
Airline company
<= 16 characters
pieces
string 
optional
Total pieces
weight
string 
optional
Total gross weight
volume
string 
optional
Total volume
flightNo
string 
optional
Flight number
<= 32 characters
orgCd
string 
optional
Origin code
<= 8 characters
org
string 
optional
Origin
<= 128 characters
destCd
string 
optional
Destination code
<= 8 characters
dest
string 
optional
Destination
<= 128 characters
etd
string <date-time>
optional
Estimated time of departure
atd
string <date-time>
optional
Actual time of departure
eta
string <date-time>
optional
Estimated time of arrival
ata
string <date-time>
optional
Actual time of arrival
currentStatusCd
string 
optional
Current status code
<= 12 characters
currentStatus
string 
optional
Current status description
<= 16 characters
currentStatusTime
string <date-time>
optional
Current status time
currentPlaceCd
string 
optional
Current location code
<= 128 characters
currentPlace
string 
optional
Current location name
<= 128 characters
firstETA
string <date-time>
optional
The first estimated arrival time obtained after takeoff
trackStatus
string 
optional
Tracking status(T=Tracking, E=Tracking completed, F=Tracking failed)
<= 20 characters
endStatus
string 
optional
End status(Null value=Unfinished, E=Normal end, EF=Forced end)
<= 20 characters
endTrackTime
string <date-time>
optional
End time
errorStatus
string 
optional
Error status(T=Tips, E=Error or null value)
<= 20 characters
errorMessage
string 
optional
<= 255 characters
dataStatus
string 
optional
Data status(Y=with data,B=airline website has no data,or is null value)
<= 20 characters
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
billCreateTime
string <date-time>
optional
Subscription time
firstUpdateTime
string <date-time>
optional
First data update time
dataUpdateTime
string <date-time>
optional
Data update time
airFlightInfo
array [object {14}] 
optional
Flight information Array
airStatusInfo
array [object {14}] 
optional
Air Transport dynamic information Array
Example
{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": [
        {
            "id": "1912707297906397184",
            "deliveryNo": "",
            "orderNo": "",
            "localKey": "",
            "orgCode": "",
            "customer": "",
            "awbNo": "15734177091",
            "referenceNo": "157-34177091",
            "carrierCd": "QR",
            "carrier": "卡塔尔航空",
            "pieces": "",
            "weight": "",
            "volume": "",
            "flightNo": "QR1377",
            "orgCd": "CAN",
            "org": "CAN",
            "destCd": "JNB",
            "dest": "JNB",
            "etd": "2024-11-25 03:35:00",
            "atd": "2024-11-25 03:35:00",
            "eta": "2024-11-26 15:59:00",
            "ata": "2024-11-26 15:59:00",
            "currentStatusCd": "End",
            "currentStatus": "结束跟踪",
            "currentStatusTime": "2024-12-12 15:17:00",
            "currentPlaceCd": "",
            "currentPlace": "JNB",
            "firstETA": "2024-11-26 15:59:00",
            "trackStatus": "E",
            "endStatus": "E",
            "endTrackTime": "2024-12-12 15:17:00",
            "errorStatus": "",
            "errorMessage": "",
            "dataStatus": "Y",
            "status": "S",
            "errorDes": "",
            "billCreateTime": "2025-04-17 11:18:51",
            "firstUpdateTime": "2025-04-17 11:19:13",
            "dataUpdateTime": "2025-04-19 11:29:54",
            "airFlightInfo": [
                {
                    "sno": 1,
                    "flightNo": "QR8941",
                    "flightDate": "2024-11-25 00:00:00",
                    "org": "CAN",
                    "orgCd": "CAN",
                    "dest": "",
                    "destCd": "",
                    "etd": "2024-11-25 03:35:00",
                    "eta": "2024-11-25 07:27:00",
                    "atd": "2024-11-25 03:35:00",
                    "ata": "2024-11-25 07:27:00",
                    "pieces": "25",
                    "weight": "405.000",
                    "volume": "0.970"
                },
                {
                    "sno": 2,
                    "flightNo": "QR1377",
                    "flightDate": "2024-11-26 00:00:00",
                    "org": "DOH",
                    "orgCd": "DOH",
                    "dest": "",
                    "destCd": "",
                    "etd": "2024-11-26 08:27:00",
                    "eta": "2024-11-26 15:59:00",
                    "atd": "2024-11-26 08:27:00",
                    "ata": "2024-11-26 15:59:00",
                    "pieces": "25",
                    "weight": "405.000",
                    "volume": "0.970"
                }
            ],
            "airStatusInfo": [
                {
                    "sno": 1,
                    "statusCd": "RCS",
                    "statusDesc": "进仓",
                    "statusDescEn": "Received from shipper in CAN",
                    "flightNo": "",
                    "eventTime": "2024-11-21 11:16:00",
                    "place": "CAN",
                    "placeCd": "CAN",
                    "transportMode": "",
                    "pieces": "25.000",
                    "weight": "405.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-19 11:30:34"
                },
                {
                    "sno": 2,
                    "statusCd": "DEP",
                    "statusDesc": "起飞",
                    "statusDescEn": "Departed on QR8941/25-Nov-2024 from  CAN",
                    "flightNo": "QR8941",
                    "eventTime": "2024-11-25 03:35:00",
                    "place": "CAN",
                    "placeCd": "CAN",
                    "transportMode": "",
                    "pieces": "25.000",
                    "weight": "405.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-19 11:30:34"
                },
                {
                    "sno": 3,
                    "statusCd": "TAR",
                    "statusDesc": "中转抵达",
                    "statusDescEn": "Arrived in DOH  on  QR 8941/25-Nov-2024",
                    "flightNo": "QR8941",
                    "eventTime": "2024-11-25 07:27:00",
                    "place": "DOH",
                    "placeCd": "DOH",
                    "transportMode": "",
                    "pieces": "25.000",
                    "weight": "405.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-19 11:30:34"
                },
                {
                    "sno": 4,
                    "statusCd": "TRF",
                    "statusDesc": "中转卸货",
                    "statusDescEn": "Received in DOH",
                    "flightNo": "",
                    "eventTime": "2024-11-25 19:00:00",
                    "place": "DOH",
                    "placeCd": "DOH",
                    "transportMode": "",
                    "pieces": "25.000",
                    "weight": "405.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-19 11:30:34"
                },
                {
                    "sno": 5,
                    "statusCd": "TDE",
                    "statusDesc": "中转起飞",
                    "statusDescEn": "Departed on QR1377/26-Nov-2024 from  DOH",
                    "flightNo": "QR1377",
                    "eventTime": "2024-11-26 08:27:00",
                    "place": "DOH",
                    "placeCd": "DOH",
                    "transportMode": "",
                    "pieces": "25.000",
                    "weight": "405.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-19 11:30:34"
                },
                {
                    "sno": 6,
                    "statusCd": "ARR",
                    "statusDesc": "抵达",
                    "statusDescEn": "Arrived in JNB  on  QR 1377/26-Nov-2024",
                    "flightNo": "QR1377",
                    "eventTime": "2024-11-26 15:59:00",
                    "place": "JNB",
                    "placeCd": "JNB",
                    "transportMode": "",
                    "pieces": "25.000",
                    "weight": "405.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-19 11:30:34"
                },
                {
                    "sno": 7,
                    "statusCd": "NFD",
                    "statusDesc": "到货通知",
                    "statusDescEn": "Notified consignee",
                    "flightNo": "",
                    "eventTime": "2024-11-26 17:22:00",
                    "place": "JNB",
                    "placeCd": "JNB",
                    "transportMode": "",
                    "pieces": "25.000",
                    "weight": "405.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-19 11:30:34"
                },
                {
                    "sno": 8,
                    "statusCd": "RCF",
                    "statusDesc": "卸货",
                    "statusDescEn": "Received in JNB",
                    "flightNo": "",
                    "eventTime": "2024-11-26 17:22:00",
                    "place": "JNB",
                    "placeCd": "JNB",
                    "transportMode": "",
                    "pieces": "25.000",
                    "weight": "405.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-19 11:30:34"
                },
                {
                    "sno": 9,
                    "statusCd": "DLV",
                    "statusDesc": "提货",
                    "statusDescEn": "Delivered in JNB",
                    "flightNo": "",
                    "eventTime": "2024-12-12 15:17:00",
                    "place": "JNB",
                    "placeCd": "JNB",
                    "transportMode": "",
                    "pieces": "25.000",
                    "weight": "405.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-19 11:30:34"
                }
            ]
        },
        {
            "id": "1912077293728174080",
            "deliveryNo": "",
            "orderNo": "",
            "localKey": "",
            "orgCode": "",
            "customer": "",
            "awbNo": "16092079886",
            "referenceNo": "160-92079886",
            "carrierCd": "CX",
            "carrier": "国泰航空",
            "pieces": "1",
            "weight": "48.000",
            "volume": "",
            "flightNo": "QT4033",
            "orgCd": "PEK",
            "org": "PEK",
            "destCd": "SAP",
            "dest": "SAP",
            "etd": "2025-02-03 16:45:00",
            "atd": "2025-02-03 16:33:00",
            "eta": "",
            "ata": "",
            "currentStatusCd": "TRF",
            "currentStatus": "中转卸货",
            "currentStatusTime": "2025-02-06 02:07:00",
            "currentPlaceCd": "",
            "currentPlace": "MIA",
            "firstETA": "",
            "trackStatus": "T",
            "endStatus": "",
            "endTrackTime": "",
            "errorStatus": "",
            "errorMessage": "",
            "dataStatus": "Y",
            "status": "S",
            "errorDes": "",
            "billCreateTime": "2025-04-15 17:35:26",
            "firstUpdateTime": "2025-04-15 17:37:10",
            "dataUpdateTime": "2025-04-25 15:38:04",
            "airFlightInfo": [
                {
                    "sno": 1,
                    "flightNo": "CX331",
                    "flightDate": "2025-02-03 00:00:00",
                    "org": "PEK",
                    "orgCd": "PEK",
                    "dest": "",
                    "destCd": "",
                    "etd": "2025-02-03 16:45:00",
                    "eta": "2025-02-03 19:50:00",
                    "atd": "2025-02-03 16:33:00",
                    "ata": "2025-02-03 19:53:00",
                    "pieces": "1",
                    "weight": "48.000",
                    "volume": ""
                },
                {
                    "sno": 2,
                    "flightNo": "CX092",
                    "flightDate": "2025-02-05 00:00:00",
                    "org": "HKG",
                    "orgCd": "HKG",
                    "dest": "",
                    "destCd": "",
                    "etd": "2025-02-05 12:10:00",
                    "eta": "2025-02-05 17:55:00",
                    "atd": "2025-02-05 12:09:00",
                    "ata": "2025-02-05 17:53:00",
                    "pieces": "1",
                    "weight": "48.000",
                    "volume": ""
                },
                {
                    "sno": 3,
                    "flightNo": "QT4033",
                    "flightDate": "",
                    "org": "MIA",
                    "orgCd": "MIA",
                    "dest": "",
                    "destCd": "",
                    "etd": "",
                    "eta": "",
                    "atd": "",
                    "ata": "",
                    "pieces": "4",
                    "weight": "45.000",
                    "volume": ""
                }
            ],
            "airStatusInfo": [
                {
                    "sno": 1,
                    "statusCd": "",
                    "statusDesc": "Freight On Hand",
                    "statusDescEn": "Freight On Hand",
                    "flightNo": "",
                    "eventTime": "2025-02-01 16:25:00",
                    "place": "PEK",
                    "placeCd": "PEK",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 2,
                    "statusCd": "RCS",
                    "statusDesc": "进仓",
                    "statusDescEn": "Airline Received",
                    "flightNo": "",
                    "eventTime": "2025-02-03 09:02:00",
                    "place": "PEK",
                    "placeCd": "PEK",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 3,
                    "statusCd": "MAN",
                    "statusDesc": "配载",
                    "statusDescEn": "Manifest Received",
                    "flightNo": "CX331",
                    "eventTime": "2025-02-03 13:51:00",
                    "place": "PEK",
                    "placeCd": "PEK",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 4,
                    "statusCd": "DEP",
                    "statusDesc": "起飞",
                    "statusDescEn": "Departed",
                    "flightNo": "CX331",
                    "eventTime": "2025-02-03 16:33:00",
                    "place": "PEK",
                    "placeCd": "PEK",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 5,
                    "statusCd": "",
                    "statusDesc": "Custom Cleared",
                    "statusDescEn": "Custom Cleared",
                    "flightNo": "",
                    "eventTime": "2025-02-03 19:01:00",
                    "place": "HKG",
                    "placeCd": "HKG",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 6,
                    "statusCd": "TAR",
                    "statusDesc": "中转抵达",
                    "statusDescEn": "Arrived",
                    "flightNo": "CX331",
                    "eventTime": "2025-02-03 19:53:00",
                    "place": "HKG",
                    "placeCd": "HKG",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 7,
                    "statusCd": "TRF",
                    "statusDesc": "中转卸货",
                    "statusDescEn": "Freight Accepted at Airport",
                    "flightNo": "CX331",
                    "eventTime": "2025-02-03 20:46:00",
                    "place": "HKG",
                    "placeCd": "HKG",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 8,
                    "statusCd": "MAN",
                    "statusDesc": "配载",
                    "statusDescEn": "Manifest Received",
                    "flightNo": "CX092",
                    "eventTime": "2025-02-05 11:14:00",
                    "place": "HKG",
                    "placeCd": "HKG",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 9,
                    "statusCd": "TDE",
                    "statusDesc": "中转起飞",
                    "statusDescEn": "Departed",
                    "flightNo": "CX092",
                    "eventTime": "2025-02-05 12:09:00",
                    "place": "HKG",
                    "placeCd": "HKG",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 10,
                    "statusCd": "TAR",
                    "statusDesc": "中转抵达",
                    "statusDescEn": "Arrived",
                    "flightNo": "CX092",
                    "eventTime": "2025-02-05 17:53:00",
                    "place": "MIA",
                    "placeCd": "MIA",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 11,
                    "statusCd": "TRF",
                    "statusDesc": "中转卸货",
                    "statusDescEn": "Freight Accepted at Airport",
                    "flightNo": "CX092",
                    "eventTime": "2025-02-06 02:07:00",
                    "place": "MIA",
                    "placeCd": "MIA",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                },
                {
                    "sno": 12,
                    "statusCd": "",
                    "statusDesc": "Freight Transferred to Airline",
                    "statusDescEn": "Freight Transferred to Airline",
                    "flightNo": "",
                    "eventTime": "2025-02-07 08:31:00",
                    "place": "MIA",
                    "placeCd": "MIA",
                    "transportMode": "",
                    "pieces": "1.000",
                    "weight": "48.000",
                    "volume": "",
                    "isEstimate": false,
                    "dateUpdateTime": "2025-04-25 15:39:37"
                }
            ]
        }
    ]
}
Modified at 2025-06-26 09:25:17
Previous
Air Tracking Push
Built with