API for tracking air cargo shipments by Air Waybill (AWB) number. Returns the current shipment status, route, event history, and flight path coordinates.
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.
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.
1https://api.qubictron.com/tracking/v1
All endpoints are only accessible via HTTPS and are located at api.qubictron.com
get/airReturns 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.
The HTTP status follows status_code: request and key errors answer 4xx, an internal error answers 500, and every carrier-side outcome (CARRIER_NO_RESPONSE, CARRIER_INFO_NOT_PROVIDED, …) answers 200 with success: false and an empty data.
Query parameters not listed below are reported back in meta.request.params.unknown_params and may be rejected with WRONG_PARAMETERS.
x-api-key: YOUR_API_KEY If the key is missing or invalid, the API returns HTTP 401 with {"success": false, "status_code": "INVALID_API_KEY"}
Example: x-api-key: 123
Content-Typeapplication/json
Air Waybill number in the format XXX-XXXXXXXX, where the first three digits are the airline prefix code and the remaining eight digits are the serial number. Spaces and a missing hyphen are tolerated (61849256583 is read as 618-49256583).
Example:618-49256583
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
When set to true, returns the most recent stored successful result for this AWB without contacting the airline. If nothing is stored yet, the request is processed as usual.
Default:false
Accepted for backward compatibility and echoed in meta.request.params; it has no effect on the response.
Default:false
The request was processed. success: true with status_code: "OK" carries shipment data; success: false with a carrier-side status_code (see ErrorResponse) carries an empty data.
1{
2 "success": true,
3 "status_code": "OK",
4 "meta": {
5 "request": {
6 "params": {
7 "awb_number": "001-28124600",
8 "last_successful": false,
9 "force_update": false,
10 "route_path": false,
11 "unknown_params": []
12 }
13 },
14 "airline": {
15 "name": "American Airlines",
16 "iata_code": "AA",
17 "icao_code": "AAL"
18 }
19 },
20 "data": {
21 "shipment": {
22 "awb_number": "001-28124600",
23 "status": "OK",
24 "updated_at": "2026-10-19 14:42:53",
25 "departure": {
26 "location": "FRA",
27 "estimated": "2026-09-05T11:00:00+02:00",
28 "actual": "2026-09-05T12:00:00+02:00"
29 },
30 "arrival": {
31 "location": "EZE",
32 "estimated": "2026-09-21T11:05:00-03:00",
33 "actual": "2026-09-21T10:38:00-03:00"
34 },
35 "cargo_details": {
36 "quantity": 2,
37 "weight": 2243
38 }
39 },
40 "locations": [
41 {
42 "id": "FRA",
43 "name": "Frankfurt am Main International Airport",
44 "nearest_city": "Frankfurt am Main",
45 "state": "Hesse",
46 "country": {
47 "code": "DE",
48 "name": "Germany"
49 },
50 "iata_code": "FRA",
51 "icao_code": "EDDF",
52 "unlocode": null,
53 "coordinates": {
54 "lat": 50.0264015198,
55 "lng": 8.543129921
56 },
57 "timezone": "Europe/Berlin"
58 },
59 {
60 "id": "EZE",
61 "name": "Ministro Pistarini International Airport",
62 "nearest_city": "Ezeiza",
63 "state": "Buenos-Aires",
64 "country": {
65 "code": "AR",
66 "name": "Argentina"
67 },
68 "iata_code": "EZE",
69 "icao_code": "SAEZ",
70 "unlocode": null,
71 "coordinates": {
72 "lat": -34.8222,
73 "lng": -58.5358
74 },
75 "timezone": "America/Argentina/Buenos_Aires"
76 },
77 {
78 "id": "BCN",
79 "name": "Barcelona International Airport",
80 "nearest_city": "Barcelona",
81 "state": "Catalonia",
82 "country": {
83 "code": "ES",
84 "name": "Spain"
85 },
86 "iata_code": "BCN",
87 "icao_code": "LEBL",
88 "unlocode": null,
89 "coordinates": {
90 "lat": 41.2971000671,
91 "lng": 2.0784599781
92 },
93 "timezone": "Europe/Madrid"
94 }
95 ],
96 "route_segments": [
97 {
98 "sequence": 1,
99 "departure": {
100 "location": "FRA",
101 "estimated": "2026-09-05T11:00:00+02:00",
102 "actual": "2026-09-05T12:00:00+02:00"
103 },
104 "arrival": {
105 "location": "BCN",
106 "estimated": "2026-09-07T01:00:00+02:00",
107 "actual": "2026-09-06T18:55:00+02:00"
108 },
109 "transport": {
110 "mode": "PLANE",
111 "number": "AA7244"
112 },
113 "cargo_details": {
114 "quantity": 2,
115 "weight": 2243
116 }
117 }
118 ],
119 "events": [
120 {
121 "sequence": 1,
122 "code": "BKD",
123 "description": "Booked",
124 "location": "FRA",
125 "date_time": {
126 "estimated": null,
127 "actual": "2026-08-28T12:14:00+02:00"
128 },
129 "departure": {
130 "location": "FRA",
131 "estimated": "2026-09-05T11:00:00+02:00"
132 },
133 "arrival": {
134 "location": "BCN",
135 "estimated": "2026-09-07T01:00:00+02:00"
136 },
137 "transport": {
138 "mode": "PLANE",
139 "number": "AA7244"
140 },
141 "cargo_details": {
142 "quantity": 2,
143 "weight": 2243
144 }
145 },
146 {
147 "sequence": 5,
148 "code": "DEP",
149 "description": "Departure",
150 "location": "FRA",
151 "date_time": {
152 "estimated": null,
153 "actual": "2026-09-05T12:00:00+02:00"
154 },
155 "transport": {
156 "mode": "PLANE",
157 "number": "AA7244"
158 },
159 "cargo_details": {
160 "quantity": 2,
161 "weight": 2243
162 }
163 },
164 {
165 "sequence": 23,
166 "code": "DLV",
167 "description": "Delivery",
168 "location": "EZE",
169 "date_time": {
170 "estimated": null,
171 "actual": "2026-09-21T16:37:00-03:00"
172 },
173 "transport": {
174 "mode": "PLANE",
175 "number": null
176 },
177 "cargo_details": {
178 "quantity": 2,
179 "weight": 2243
180 }
181 }
182 ]
183 }
184}1{
2 "success": false,
3 "status_code": "CARRIER_NO_RESPONSE",
4 "meta": {
5 "request": {
6 "params": {
7 "awb_number": "001-28124600",
8 "last_successful": false,
9 "force_update": false,
10 "route_path": false,
11 "unknown_params": []
12 }
13 },
14 "airline": {
15 "name": "American Airlines",
16 "iata_code": "AA",
17 "icao_code": "AAL"
18 }
19 },
20 "data": []
21}get/air/carriersReturns a list of all airlines supported by the tracking API, including their identifiers and current operational status. This endpoint does not require authentication.
Content-Typeapplication/json
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}