GETAPI key

Track an air waybill

GETapi.aircargomcp.com/track/{awb}

One 11-digit AWB in; status, route, flights, pieces and weight out, with Cargo-IMP milestones normalised to a single timeline.

Path parameters

awbstringrequired

Air waybill, any format. The 3-digit prefix identifies the airline.

Response fields

Derived from the example response.

dataobject

The payload. Everything an endpoint returns sits under this key.

data.awbstring

Air waybill number.

data.airline_iatastring

Airline 2-letter IATA code.

data.airline_namestring

Airline name.

data.statusstring

Current normalised status of the shipment. Ocean lifecycle order: discharged, available, delivered, returned_empty. Two values end a shipment, delivered and returned_empty, and returned_empty outranks delivered.

data.originstring

Origin code (airport IATA or UN/LOCODE).

data.destinationstring

Destination code (airport IATA or UN/LOCODE).

data.piecesnumber

Number of pieces.

data.weight_kgnumber

Gross weight in kilograms.

data.flight_numberstring

Operating flight number.

data.etastring

Arrival time (ISO 8601). Null when the carrier publishes none and we cannot predict one.

data.eta_is_actualboolean

True when arrival is confirmed rather than estimated.

data.eventsobject[]

Milestone timeline, oldest to newest.

data.events[].codestring

Event or status code.

data.events[].namestring

Human-readable name.

data.events[].stationstring

Airport station code.

data.events[].atstring

curl 'https://api.aircargomcp.com/track/020-12345675' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.aircargomcp.com/track/020-12345675", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.aircargomcp.com/track/020-12345675",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": {
    "awb": "020-12345675",
    "airline_iata": "LH",
    "airline_name": "Lufthansa Cargo",
    "status": "In transit",
    "origin": "FRA", "destination": "JFK",
    "pieces": 4, "weight_kg": 512,
    "flight_number": "LH8160",
    "eta": "2026-08-05T14:20:00Z",
    "eta_is_actual": false,
    "events": [
      { "code": "RCS", "name": "Received from shipper",
        "station": "FRA", "at": "2026-08-03T08:00:00Z" }
    ]
  }
}