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

Air Tracking Push

POST
When there is a change in the dynamics, our company will automatically push all the data to your company. Therefore, we need your company to provide the API address for receiving the data.

Request

Body Params application/json
id
integer 
required
The ID returned by the Subscription interface
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
extendNo
string 
optional
Extended data Json
awbNo
string 
required
Air waybill number
<= 11 characters
referenceNo
string 
required
Subscription number (AWB Number)
<= 32 characters
carrierCd
string 
required
IATA Code
<= 16 characters
carrier
string 
optional
Airline company
<= 16 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
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
atd
string <date-time>
optional
Actual time of departure
etd
string <date-time>
optional
Estimated time of departure
ata
string <date-time>
optional
Actual time of arrival
eta
string <date-time>
optional
Estimated time of arrival
endTrackTime
string <date-time>
optional
End time
currentStatusCd
string 
optional
Current dynamic code
<= 12 characters
currentStatus
string 
optional
Current status
<= 16 characters
currentStatusTime
string <date-time>
optional
Current status time
currentPlaceCd
string 
optional
Current status location code
<= 128 characters
currentPlace
string 
optional
Current dynamic location
<= 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
endId
integer 
optional
End status sign(0=Unfinished, other=Finished)
endStatus
string 
optional
End status(Null value=Unfinished, E=Normal end, EF=Forced end)
<= 20 characters
errorStatus
string 
optional
Error status(T=Tips, E=Error or null value)
<= 10 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
serviceType
string 
optional
Service type
<= 64 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}] 
required
Flight information Array
sno
integer 
required
Serial number
flightNo
string 
optional
Flight number
<= 64 characters
flightDate
string <date-time>
optional
Flight date
org
string 
optional
Origin
<= 128 characters
orgCd
string 
optional
Origin code
<= 8 characters
dest
string 
optional
Destination
<= 128 characters
destCd
string 
optional
Destination code
<= 8 characters
etd
string <date-time>
optional
Estimated time of departure
eta
string <date-time>
optional
Estimated time of arrival
atd
string <date-time>
optional
Actual time of departure
ata
string <date-time>
optional
Actual time of arrival
pieces
string 
optional
weight
string 
optional
volume
string 
optional
airStatusInfo
array [object {14}] 
required
Air Transport dynamic information Array
sno
integer 
required
Serial number
statusCd
string 
optional
Status code
<= 12 characters
statusDesc
string 
optional
Chinese Status description
<= 255 characters
statusDescEn
string 
optional
Status description
<= 255 characters
flightNo
string 
optional
Flight number
<= 64 characters
eventTime
string <date-time>
optional
Status event time
place
string 
optional
Event place
<= 128 characters
placeCd
string 
optional
Event place code
<= 128 characters
transportMode
string 
optional
Transport Mode
<= 36 characters
pieces
string 
optional
Pieces
weight
string 
optional
Gross weight
volume
string 
optional
Volume
isEstimate
boolean 
optional
Whether it is estimated (true=estimated，false=actual)
dateUpdateTime
string <date-time>
optional
Data update time
Example
[
    {
        "id": 1917025389742526500,
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "extendNo": "",
        "awbNo": "04732121386",
        "referenceNo": "047-32121386",
        "carrierCd": "TP",
        "carrier": "葡萄牙航空",
        "status": "S",
        "errorDes": "",
        "pieces": "",
        "weight": "1300",
        "volume": "",
        "flightNo": "",
        "orgCd": "CDG",
        "org": "CDG",
        "destCd": "CCS",
        "dest": "CCS",
        "atd": "",
        "etd": "2025-05-02 20:00:00",
        "ata": "",
        "eta": "",
        "endTrackTime": "",
        "currentStatusCd": "TAR",
        "currentStatus": "中转抵达",
        "currentStatusTime": "2025-05-03 22:43:00",
        "currentPlaceCd": "",
        "currentPlace": "LIS",
        "firstEta": "",
        "trackStatus": "T",
        "endId": 0,
        "endStatus": "",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "serviceType": "",
        "billCreateTime": "2025-04-29 09:17:24",
        "firstUpdateTime": "2025-04-29 09:17:24",
        "dataUpdateTime": "2025-05-14 18:06:23",
        "airFlightInfo": [
            {
                "sno": 1,
                "flightNo": "TP4000F",
                "flightDate": "2025-05-02 20:00:00",
                "org": "CDG",
                "orgCd": "CDG",
                "dest": "LIS",
                "destCd": "LIS",
                "etd": "2025-05-02 20:00:00",
                "eta": "",
                "atd": "",
                "ata": "2025-05-03 22:43:00",
                "pieces": "",
                "weight": "130",
                "volume": "5"
            },
            {
                "sno": 2,
                "flightNo": "TP171",
                "flightDate": "2025-05-24 12:35:00",
                "org": "LIS",
                "orgCd": "LIS",
                "dest": "CCS",
                "destCd": "CCS",
                "etd": "2025-05-24 12:35:00",
                "eta": "",
                "atd": "",
                "ata": "",
                "pieces": "",
                "weight": "130",
                "volume": "5"
            }
        ],
        "airStatusInfo": [
            {
                "sno": 1,
                "statusCd": "DEP",
                "statusDesc": "起飞",
                "statusDescEn": "DEP",
                "flightNo": "TP4000F",
                "eventTime": "2025-05-02 20:00:00",
                "place": "CDG",
                "placeCd": "CDG",
                "transportMode": "",
                "pieces": "",
                "weight": "130",
                "volume": "5",
                "isEstimate": true,
                "dateUpdateTime": "2025-05-14 18:11:27"
            },
            {
                "sno": 2,
                "statusCd": "TAR",
                "statusDesc": "中转抵达",
                "statusDescEn": "ARR",
                "flightNo": "TP4000F",
                "eventTime": "2025-05-03 22:43:00",
                "place": "LIS",
                "placeCd": "LIS",
                "transportMode": "",
                "pieces": "",
                "weight": "130",
                "volume": "5",
                "isEstimate": false,
                "dateUpdateTime": "2025-05-14 18:11:27"
            },
            {
                "sno": 3,
                "statusCd": "TDE",
                "statusDesc": "中转起飞",
                "statusDescEn": "DEP",
                "flightNo": "TP171",
                "eventTime": "2025-05-24 12:35:00",
                "place": "LIS",
                "placeCd": "LIS",
                "transportMode": "",
                "pieces": "",
                "weight": "130",
                "volume": "5",
                "isEstimate": true,
                "dateUpdateTime": "2025-05-14 18:11:27"
            }
        ]
    }
]

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": 1917025389742526500,
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "extendNo": "",
        "awbNo": "04732121386",
        "referenceNo": "047-32121386",
        "carrierCd": "TP",
        "carrier": "葡萄牙航空",
        "status": "S",
        "errorDes": "",
        "pieces": "",
        "weight": "1300",
        "volume": "",
        "flightNo": "",
        "orgCd": "CDG",
        "org": "CDG",
        "destCd": "CCS",
        "dest": "CCS",
        "atd": "",
        "etd": "2025-05-02 20:00:00",
        "ata": "",
        "eta": "",
        "endTrackTime": "",
        "currentStatusCd": "TAR",
        "currentStatus": "中转抵达",
        "currentStatusTime": "2025-05-03 22:43:00",
        "currentPlaceCd": "",
        "currentPlace": "LIS",
        "firstEta": "",
        "trackStatus": "T",
        "endId": 0,
        "endStatus": "",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "serviceType": "",
        "billCreateTime": "2025-04-29 09:17:24",
        "firstUpdateTime": "2025-04-29 09:17:24",
        "dataUpdateTime": "2025-05-14 18:06:23",
        "airFlightInfo": [
            {
                "sno": 1,
                "flightNo": "TP4000F",
                "flightDate": "2025-05-02 20:00:00",
                "org": "CDG",
                "orgCd": "CDG",
                "dest": "LIS",
                "destCd": "LIS",
                "etd": "2025-05-02 20:00:00",
                "eta": "",
                "atd": "",
                "ata": "2025-05-03 22:43:00",
                "pieces": "",
                "weight": "130",
                "volume": "5"
            },
            {
                "sno": 2,
                "flightNo": "TP171",
                "flightDate": "2025-05-24 12:35:00",
                "org": "LIS",
                "orgCd": "LIS",
                "dest": "CCS",
                "destCd": "CCS",
                "etd": "2025-05-24 12:35:00",
                "eta": "",
                "atd": "",
                "ata": "",
                "pieces": "",
                "weight": "130",
                "volume": "5"
            }
        ],
        "airStatusInfo": [
            {
                "sno": 1,
                "statusCd": "DEP",
                "statusDesc": "起飞",
                "statusDescEn": "DEP",
                "flightNo": "TP4000F",
                "eventTime": "2025-05-02 20:00:00",
                "place": "CDG",
                "placeCd": "CDG",
                "transportMode": "",
                "pieces": "",
                "weight": "130",
                "volume": "5",
                "isEstimate": true,
                "dateUpdateTime": "2025-05-14 18:11:27"
            },
            {
                "sno": 2,
                "statusCd": "TAR",
                "statusDesc": "中转抵达",
                "statusDescEn": "ARR",
                "flightNo": "TP4000F",
                "eventTime": "2025-05-03 22:43:00",
                "place": "LIS",
                "placeCd": "LIS",
                "transportMode": "",
                "pieces": "",
                "weight": "130",
                "volume": "5",
                "isEstimate": false,
                "dateUpdateTime": "2025-05-14 18:11:27"
            },
            {
                "sno": 3,
                "statusCd": "TDE",
                "statusDesc": "中转起飞",
                "statusDescEn": "DEP",
                "flightNo": "TP171",
                "eventTime": "2025-05-24 12:35:00",
                "place": "LIS",
                "placeCd": "LIS",
                "transportMode": "",
                "pieces": "",
                "weight": "130",
                "volume": "5",
                "isEstimate": true,
                "dateUpdateTime": "2025-05-14 18:11:27"
            }
        ]
    }
]'

Responses

🟢200成功
application/json
Body
code
integer 
required
Push status(200=successful,other=failed)
message
string 
required
Status description message
type 
string 
required
S= Success,W=Warning, E=Anomaly
time
string 
required
Time
Example
{
    "code": 200,
    "type": "S",
    "message": null,
    "time": "2023-12-13 01:20:38"
}
Modified at 2025-06-12 19:24:58
Previous
Bulk Air Tracking Subscribe
Next
Bulk Air Tracking Download
Built with