TrackingEyes-API
  1. Global Air Cargo Tracking
TrackingEyes-API
  • Authentication
    • OAuth
      POST
  • Global Ocean Cargo Tracking
    • Ocean Status Code
    • Ocean Support List
    • Ocean Tracking Subscribe
      POST
    • Data Push Webhook
      POST
  • Global Air Cargo Tracking
    • Air Status Code
    • Air Support List
    • Air Tracking Subscribe
      POST
    • Data Push Webhook
      POST
  1. Global Air Cargo Tracking

Data Push Webhook

POST
Your company needs to provide the API address, thank you! (When the dynamic changes, your company interface will be called to push the latest dynamic)

Request

Body Params application/json
id
integer 
required
Airway bill id: snowflake id
deliveryNo
string 
optional
Delivery note number
<= 38 characters
orderNo
string 
optional
Order number
<= 600 characters
localKey
string 
optional
Customer Local Keywords
<= 38 characters
extendNo
string 
optional
Extended data Json, the length is uncertain
awbNo
string 
required
The number of the airfreight master bill
<= 11 characters
referenceNo
string 
required
Subscription number (AWB NO.)
<= 32 characters
carrierCd
string 
required
Airline IATA
<= 16 characters
carrier
string 
optional
Airline abbreviation
<= 16 characters
flightNo
string 
optional
Flight number
<= 32 characters
orgCd
string 
optional
Departure code
<= 8 characters
org
string 
optional
Departure name
<= 128 characters
destCd
string 
optional
Destination code
<= 8 characters
dest
string 
optional
Destination name
<= 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 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: ""=Unfinished, E=Normal end, EF=Forced end
<= 20 characters
errorStatus
string 
optional
Error status, T=Tips, E=Error (null value)
<= 10 characters
errorMessage
string 
optional
Error status supplementary remarks
<= 255 characters
endId
integer 
optional
Unique identifier of end status: 0=Unfinished, other=Finished
serviceType
string 
optional
Service type
<= 64 characters
airFlightInfo
array [object {14}] 
required
Flight information
sno
integer 
required
Serial number
flightNo
string 
optional
Flight number
<= 64 characters
flightDate
string <date-time>
optional
Flight date
org
string 
optional
Departure name
<= 128 characters
orgCd
string 
optional
Departure code
<= 8 characters
dest
string 
optional
Destination name
<= 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
Number of pieces: the string value is integer number data
weight
string 
optional
Gross weight: the string value is the twelve-digit number with three decimal places
volume
string 
optional
Volume: the string value is the twelve-digit number with three decimal places
airStatusInfo
array [object {14}] 
required
Air traffic dynamic information
sno
integer 
required
Serial number
statusCd
string 
optional
Status code
<= 12 characters
statusDesc
string 
optional
Status code description
<= 255 characters
statusDescEn
string 
optional
Status code description (English)
<= 255 characters
flightNo
string 
optional
Flight number
<= 64 characters
eventTime
string <date-time>
optional
Event time
place
string 
optional
Name of the place where the status occured
<= 128 characters
placeCd
string 
optional
The code of the place where the status occured
<= 128 characters
transportMode
string 
optional
Transport mode
<= 36 characters
pieces
string 
optional
Number of pieces: the string value is integer number data
weight
string 
optional
Gross weight: the string value is the twelve-digit number with three decimal places
volume
string 
optional
Volume: the string value is the twelve-digit number with three decimal places
isEstimate
boolean 
optional
Whether it is estimated
dateUpdateTime
string <date-time>
optional
Data update time
Example
[
  {
    "id": 634286762385477,
    "deliveryNo": "",
    "orderNo": "",
    "localKey": "",
    "extendNo": "",
    "awbNo": "02019428765",
    "referenceNo": "020-19428765",
    "carrierCd": "LH",
    "carrier": "",
    "flightNo": "",
    "orgCd": "PEK",
    "org": "PEK (Beijing)",
    "destCd": "KTW",
    "dest": "KTW (Katowice)",
    "atd": "",
    "etd": "2025/1/24 5:25:00",
    "ata": "",
    "eta": "2025/1/27 6:00:00",
    "endTrackTime": "",
    "currentStatusCd": "BKD",
    "currentStatus": "",
    "currentStatusTime": "2025/1/22 15:29:00",
    "currentPlaceCd": "",
    "currentPlace": "PEK (Beijing)",
    "firstETA": "",
    "trackStatus": "B",
    "endStatus": "",
    "errorStatus": "",
    "errorMessage": "",
    "endId": 0,
    "serviceType": "",
    "airFlightInfo": [
      {
        "sno": 1,
        "flightNo": "LH8431",
        "flightDate": "2025/1/24 0:00:00",
        "org": "PEK (Beijing)",
        "orgCd": "PEK",
        "dest": "FRA (Frankfurt)",
        "destCd": "FRA",
        "etd": "2025/1/24 5:25:00",
        "eta": "2025/1/24 11:05:00",
        "atd": "",
        "ata": "",
        "pieces": "5",
        "weight": "129",
        "volume": ""
      },
      {
        "sno": 2,
        "flightNo": "LH7422S",
        "flightDate": "2025/1/26 0:00:00",
        "org": "FRA (Frankfurt)",
        "orgCd": "FRA",
        "dest": "KTW (Katowice)",
        "destCd": "KTW",
        "etd": "2025/1/26 17:10:00",
        "eta": "2025/1/27 6:00:00",
        "atd": "",
        "ata": "",
        "pieces": "5",
        "weight": "129",
        "volume": ""
      }
    ],
    "airStatusInfo": [
      {
        "sno": 2,
        "statusCd": "RCS",
        "statusDesc": "进仓",
        "statusDescEn": "Shipment accepted",
        "flightNo": "",
        "eventTime": "2025/1/23 23:25:00",
        "place": "PEK (Beijing)",
        "placeCd": "PEK",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 10,
        "statusCd": "RCF",
        "statusDesc": "卸货",
        "statusDescEn": "Received from flight",
        "flightNo": "LH7422S",
        "eventTime": "2025/1/27 11:40:00",
        "place": "KTW (Katowice)",
        "placeCd": "KTW",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 6,
        "statusCd": "TRF",
        "statusDesc": "中转卸货",
        "statusDescEn": "Received from flight",
        "flightNo": "LH8431",
        "eventTime": "2025/1/24 16:05:00",
        "place": "FRA (Frankfurt)",
        "placeCd": "FRA",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 7,
        "statusCd": "MAN",
        "statusDesc": "配载",
        "statusDescEn": "Manifested",
        "flightNo": "LH7422S",
        "eventTime": "2025/1/26 15:58:00",
        "place": "FRA (Frankfurt)",
        "placeCd": "FRA",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 11,
        "statusCd": "NFD",
        "statusDesc": "到货通知",
        "statusDescEn": "Ready for pick-up",
        "flightNo": "",
        "eventTime": "2025/1/27 12:00:00",
        "place": "KTW (Katowice)",
        "placeCd": "KTW",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 4,
        "statusCd": "DEP",
        "statusDesc": "起飞",
        "statusDescEn": "Departed",
        "flightNo": "LH8431",
        "eventTime": "2025/1/24 5:25:00",
        "place": "PEK (Beijing)",
        "placeCd": "PEK",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 8,
        "statusCd": "TDE",
        "statusDesc": "中转起飞",
        "statusDescEn": "Departed",
        "flightNo": "LH7422S",
        "eventTime": "2025/1/26 17:10:00",
        "place": "FRA (Frankfurt)",
        "placeCd": "FRA",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 9,
        "statusCd": "ARR",
        "statusDesc": "抵达",
        "statusDescEn": "Arrived",
        "flightNo": "LH7422S",
        "eventTime": "2025/1/27 6:00:00",
        "place": "KTW (Katowice)",
        "placeCd": "KTW",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 3,
        "statusCd": "MAN",
        "statusDesc": "配载",
        "statusDescEn": "Manifested",
        "flightNo": "LH8431",
        "eventTime": "2025/1/24 5:19:00",
        "place": "PEK (Beijing)",
        "placeCd": "PEK",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 1,
        "statusCd": "BKD",
        "statusDesc": "订舱",
        "statusDescEn": "Booking  confirmed ",
        "flightNo": "",
        "eventTime": "2025/1/22 15:29:00",
        "place": "PEK (Beijing)",
        "placeCd": "PEK",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": false,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 5,
        "statusCd": "TAR",
        "statusDesc": "中转抵达",
        "statusDescEn": "Arrived",
        "flightNo": "LH8431",
        "eventTime": "2025/1/24 11:05:00",
        "place": "FRA (Frankfurt)",
        "placeCd": "FRA",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 12,
        "statusCd": "DLV",
        "statusDesc": "提货",
        "statusDescEn": "Delivered",
        "flightNo": "",
        "eventTime": "2025/1/27 12:00:00",
        "place": "KTW (Katowice)",
        "placeCd": "KTW",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      }
    ]
  }
]

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": 634286762385477,
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "extendNo": "",
        "awbNo": "02019428765",
        "referenceNo": "020-19428765",
        "carrierCd": "LH",
        "carrier": "",
        "flightNo": "",
        "orgCd": "PEK",
        "org": "PEK (Beijing)",
        "destCd": "KTW",
        "dest": "KTW (Katowice)",
        "atd": "",
        "etd": "2025/1/24 5:25:00",
        "ata": "",
        "eta": "2025/1/27 6:00:00",
        "endTrackTime": "",
        "currentStatusCd": "BKD",
        "currentStatus": "",
        "currentStatusTime": "2025/1/22 15:29:00",
        "currentPlaceCd": "",
        "currentPlace": "PEK (Beijing)",
        "firstETA": "",
        "trackStatus": "B",
        "endStatus": "",
        "errorStatus": "",
        "errorMessage": "",
        "endId": 0,
        "serviceType": "",
        "airFlightInfo": [
            {
                "sno": 1,
                "flightNo": "LH8431",
                "flightDate": "2025/1/24 0:00:00",
                "org": "PEK (Beijing)",
                "orgCd": "PEK",
                "dest": "FRA (Frankfurt)",
                "destCd": "FRA",
                "etd": "2025/1/24 5:25:00",
                "eta": "2025/1/24 11:05:00",
                "atd": "",
                "ata": "",
                "pieces": "5",
                "weight": "129",
                "volume": ""
            },
            {
                "sno": 2,
                "flightNo": "LH7422S",
                "flightDate": "2025/1/26 0:00:00",
                "org": "FRA (Frankfurt)",
                "orgCd": "FRA",
                "dest": "KTW (Katowice)",
                "destCd": "KTW",
                "etd": "2025/1/26 17:10:00",
                "eta": "2025/1/27 6:00:00",
                "atd": "",
                "ata": "",
                "pieces": "5",
                "weight": "129",
                "volume": ""
            }
        ],
        "airStatusInfo": [
            {
                "sno": 2,
                "statusCd": "RCS",
                "statusDesc": "进仓",
                "statusDescEn": "Shipment accepted",
                "flightNo": "",
                "eventTime": "2025/1/23 23:25:00",
                "place": "PEK (Beijing)",
                "placeCd": "PEK",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 10,
                "statusCd": "RCF",
                "statusDesc": "卸货",
                "statusDescEn": "Received from flight",
                "flightNo": "LH7422S",
                "eventTime": "2025/1/27 11:40:00",
                "place": "KTW (Katowice)",
                "placeCd": "KTW",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 6,
                "statusCd": "TRF",
                "statusDesc": "中转卸货",
                "statusDescEn": "Received from flight",
                "flightNo": "LH8431",
                "eventTime": "2025/1/24 16:05:00",
                "place": "FRA (Frankfurt)",
                "placeCd": "FRA",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 7,
                "statusCd": "MAN",
                "statusDesc": "配载",
                "statusDescEn": "Manifested",
                "flightNo": "LH7422S",
                "eventTime": "2025/1/26 15:58:00",
                "place": "FRA (Frankfurt)",
                "placeCd": "FRA",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 11,
                "statusCd": "NFD",
                "statusDesc": "到货通知",
                "statusDescEn": "Ready for pick-up",
                "flightNo": "",
                "eventTime": "2025/1/27 12:00:00",
                "place": "KTW (Katowice)",
                "placeCd": "KTW",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 4,
                "statusCd": "DEP",
                "statusDesc": "起飞",
                "statusDescEn": "Departed",
                "flightNo": "LH8431",
                "eventTime": "2025/1/24 5:25:00",
                "place": "PEK (Beijing)",
                "placeCd": "PEK",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 8,
                "statusCd": "TDE",
                "statusDesc": "中转起飞",
                "statusDescEn": "Departed",
                "flightNo": "LH7422S",
                "eventTime": "2025/1/26 17:10:00",
                "place": "FRA (Frankfurt)",
                "placeCd": "FRA",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 9,
                "statusCd": "ARR",
                "statusDesc": "抵达",
                "statusDescEn": "Arrived",
                "flightNo": "LH7422S",
                "eventTime": "2025/1/27 6:00:00",
                "place": "KTW (Katowice)",
                "placeCd": "KTW",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 3,
                "statusCd": "MAN",
                "statusDesc": "配载",
                "statusDescEn": "Manifested",
                "flightNo": "LH8431",
                "eventTime": "2025/1/24 5:19:00",
                "place": "PEK (Beijing)",
                "placeCd": "PEK",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 1,
                "statusCd": "BKD",
                "statusDesc": "订舱",
                "statusDescEn": "Booking  confirmed ",
                "flightNo": "",
                "eventTime": "2025/1/22 15:29:00",
                "place": "PEK (Beijing)",
                "placeCd": "PEK",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 5,
                "statusCd": "TAR",
                "statusDesc": "中转抵达",
                "statusDescEn": "Arrived",
                "flightNo": "LH8431",
                "eventTime": "2025/1/24 11:05:00",
                "place": "FRA (Frankfurt)",
                "placeCd": "FRA",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 12,
                "statusCd": "DLV",
                "statusDesc": "提货",
                "statusDescEn": "Delivered",
                "flightNo": "",
                "eventTime": "2025/1/27 12:00:00",
                "place": "KTW (Katowice)",
                "placeCd": "KTW",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            }
        ]
    }
]'

Responses

🟢200成功
application/json
Body
code
integer 
required
Push status: 200=successful, other=failed
message
string 
required
Status description message
Example
{
  "code": 200,
  "message": "success"
}
Modified at 2025-03-18 02:35:17
Previous
Air Tracking Subscribe
Built with