Home

Air Cargo Tracking API

version 1

API for tracking air cargo shipments by Air Waybill (AWB) number. Returns the current shipment status, route, event history, and flight path coordinates.

OpenAPI Specification

Get started with your API integration in just a few minutes. The OpenAPI specification provides a complete overview of all available endpoints, request parameters, authentication methods, and response formats, allowing you to easily explore, test, and interact with the API.

General information

Air Cargo Tracking API is organized around REST.
The API uses predictable resource-based URLs, supports form-encoded request payloads, returns responses in JSON format, and relies on standard HTTP methods, status codes, and authentication mechanisms.

API endpoint#

1https://api.qubictron.com/tracking/v1

All endpoints are only accessible via HTTPS and are located at api.qubictron.com

Details of the air cargo shipment

get/air

Returns full shipment details by AWB (Air Waybill) number: status, estimated and actual departure/arrival times, route segments, event history, and optionally the flight path coordinates.

Headers

Content-Typeapplication/json

Query Parameters
  • awb_numberREQUIREDstring

    Air Waybill number in the format XXX-XXXXXXXX, where the first three digits are the airline prefix code and the remaining digits are the shipment number.

    Example:618-49256583

  • route_pathOptionalboolean

    When set to true, each route segment in the response will include a route_path array of coordinates suitable for rendering on a map.

    Default:false

    Example:true

Response example
Shipment data retrieved successfully.
1{
2  "success": true,
3  "status_code": "OK",
4  "meta": {
5    "request": {
6      "params": {
7        "awb_number": "618-49256583",
8        "route_path": true
9      }
10    },
11    "airline": {
12      "name": "Singapore Airlines",
13      "iata_code": "SQ",
14      "icao_code": "SIA"
15    }
16  },
17  "data": {
18    "shipment": {
19      "awb_number": "618-49256583",
20      "status": "OK",
21      "departure": {
22        "location": "KIX",
23        "estimated": "2026-02-14T15:25:00+09:00",
24        "actual": "2026-02-14T15:31:00+09:00"
25      },
26      "arrival": {
27        "location": "MAA",
28        "estimated": "2026-02-15T22:50:00+05:30",
29        "actual": "2026-02-16T00:22:00+05:30"
30      },
31      "cargo_details": {
32        "quantity": 8,
33        "weight": 355.1
34      }
35    },
36    "locations": [
37      {
38        "id": "KIX",
39        "name": "Kansai International Airport",
40        "nearest_city": "Osaka",
41        "state": "Osaka",
42        "country": {
43          "code": "JP",
44          "name": "Japan"
45        },
46        "iata_code": "KIX",
47        "icao_code": "RJBB",
48        "unlocode": null,
49        "coordinates": {
50          "lat": 34.4272994995,
51          "lng": 135.2440032959
52        },
53        "timezone": "Asia/Tokyo"
54      },
55      {
56        "id": "SIN",
57        "name": "Singapore Changi International Airport",
58        "nearest_city": "Singapore",
59        "state": "North East",
60        "country": {
61          "code": "SG",
62          "name": "Singapore"
63        },
64        "iata_code": "SIN",
65        "icao_code": "WSSS",
66        "unlocode": null,
67        "coordinates": {
68          "lat": 1.3501900434,
69          "lng": 103.9940032959
70        },
71        "timezone": "Asia/Singapore"
72      },
73      {
74        "id": "MAA",
75        "name": "Chennai International Airport",
76        "nearest_city": "Chennai",
77        "state": "Tamil-Nadu",
78        "country": {
79          "code": "IN",
80          "name": "India"
81        },
82        "iata_code": "MAA",
83        "icao_code": "VOMM",
84        "unlocode": null,
85        "coordinates": {
86          "lat": 12.9900054932,
87          "lng": 80.1692962646
88        },
89        "timezone": "Asia/Kolkata"
90      }
91    ],
92    "route_segments": [
93      {
94        "sequence": 1,
95        "departure": {
96          "location": "KIX",
97          "estimated": "2026-02-14T15:25:00+09:00",
98          "actual": "2026-02-14T15:31:00+09:00"
99        },
100        "arrival": {
101          "location": "SIN",
102          "estimated": "2026-02-14T21:20:00+08:00",
103          "actual": "2026-02-14T21:26:00+08:00"
104        },
105        "transport": {
106          "mode": "PLANE",
107          "number": "TR 0819"
108        },
109        "cargo_details": {
110          "quantity": 8,
111          "weight": 355.1
112        },
113        "route_path": [
114          [
115            34.4272994995,
116            135.2440032959
117          ],
118          [
119            1.3501900434,
120            103.9940032959
121          ]
122        ]
123      }
124    ],
125    "events": [
126      {
127        "sequence": 1,
128        "code": "RCT",
129        "description": "Receiving from another airline",
130        "location": "KIX",
131        "date_time": {
132          "estimated": null,
133          "actual": "2026-02-13T00:00:00+09:00"
134        },
135        "transport": {
136          "mode": "PLANE",
137          "number": null
138        },
139        "cargo_details": {
140          "quantity": 8,
141          "weight": 355.1
142        }
143      },
144      {
145        "sequence": 3,
146        "code": "DEP",
147        "description": "Departure",
148        "location": "KIX",
149        "date_time": {
150          "estimated": null,
151          "actual": "2026-02-14T15:31:00+09:00"
152        },
153        "transport": {
154          "mode": "PLANE",
155          "number": "TR 0819"
156        },
157        "cargo_details": {
158          "quantity": 8,
159          "weight": 355.1
160        }
161      },
162      {
163        "sequence": 7,
164        "code": "ARR",
165        "description": "Arrival",
166        "location": "MAA",
167        "date_time": {
168          "estimated": null,
169          "actual": "2026-02-16T00:22:00+05:30"
170        },
171        "transport": {
172          "mode": "PLANE",
173          "number": "TR 0578"
174        },
175        "cargo_details": {
176          "quantity": 8,
177          "weight": 355.1
178        }
179      }
180    ]
181  }
182}

Get list of supported airlines

get/air/carriers

Returns a list of all airlines supported by the tracking API, including their identifiers and current operational status. This endpoint does not require authentication.

Headers

Content-Typeapplication/json

Response example
List of supported airlines retrieved successfully.
1{
2  "success": true,
3  "status_code": "OK",
4  "carriers": [
5    {
6      "name": "American Airlines",
7      "identifiers": {
8        "awb_prefix": "001",
9        "iata_code": "AA",
10        "icao_code": "AAL"
11      },
12      "status": {
13        "is_active": true,
14        "is_under_maintenance": false
15      }
16    },
17    {
18      "name": "Lufthansa Cargo",
19      "identifiers": {
20        "awb_prefix": "020",
21        "iata_code": "LH",
22        "icao_code": "GEC"
23      },
24      "status": {
25        "is_active": true,
26        "is_under_maintenance": false
27      }
28    }
29  ]
30}

Qubictron 2026Contact us