Home

Introduction

Air Tracking API

version 1

Air Tracking allows to determine the current position of a given cargo on the World Map. To track the location of the cargo, just specify Air Waybill (AWB) number.

OpenAPI Specification

Start designing your API in minutes. The OpenAPI specification file enables you to learn and interact with API elements, including all available endpoints, input and output representations.

General information

Air Tracking API is organized around REST.
Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

API endpoint#

1https://tracking.searates.com

All endpoints are only accessible via HTTPS and are located at tracking.searates.com

Tracking by awb number

get/air

Getting tracking information by air waybill number.

Headers

Content-Typeapplication/json

Query Parameters
  • api_keyREQUIREDstring

    Your api key. If you do not have an api key - contact us to purchase a subscription.

  • numberREQUIREDstring

    Air waybill number.

    Examples:020-17363006

  • pathOptionalboolean

    This parameter indicates whether to provide a coordinate array for each route in the response. If you do not need this data, set this parameter to false and the response size may be reduced, in some cases by more than 5 times.

    Default:true

Response example
1{
2  "success": true,
3  "status_code": "OK",
4  "metadata": {
5    "request_parameters": {
6      "number": "057-06399886"
7    },
8    "updated_at": "2024-03-04 09:38:16",
9    "airline": {
10      "name": "Air France",
11      "prefix": "057",
12      "iata_code": "AF",
13      "icao_code": "AFR",
14      "url": "https://www.airfrance.fr"
15    }
16  },
17  "data": {
18    "status": "DELIVERED",
19    "from": {
20      "name": "Los Angeles International Airport",
21      "state": "California",
22      "country": "United States",
23      "country_code": "US",
24      "locode": null,
25      "iata_code": "LAX",
26      "icao_code": "KLAX",
27      "lat": 33.9424963888889,
28      "lng": -118.408048611111,
29      "timezone": "America/Los_Angeles",
30      "nearest_city": "Los Angeles"
31    },
32    "to": {
33      "name": "Toulouse-Blagnac Airport",
34      "state": "Occitanie",
35      "country": "France",
36      "country_code": "FR",
37      "locode": null,
38      "iata_code": "TLS",
39      "icao_code": "LFBO",
40      "lat": 43.6291007996,
41      "lng": 1.3638199568,
42      "timezone": "Europe/Paris",
43      "nearest_city": "Toulouse/Blagnac"
44    },
45    "departure_datetime_local": {
46      "estimated": "2023-12-29 15:25:00",
47      "actual": "2023-12-29 15:18:00"
48    },
49    "arrival_datetime_local": {
50      "estimated": "2024-01-02 08:00:00",
51      "actual": "2024-01-02 06:30:00"
52    },
53    "piece": 2,
54    "weight": 25,
55    "flight_number": "AF0200D",
56    "routes": [
57      {
58        "order_id": 1,
59        "status": "ARRIVED",
60        "from": {
61          "name": "Los Angeles International Airport",
62          "state": "California",
63          "country": "United States",
64          "country_code": "US",
65          "locode": null,
66          "iata_code": "LAX",
67          "icao_code": "KLAX",
68          "lat": 33.9424963888889,
69          "lng": -118.408048611111,
70          "timezone": "America/Los_Angeles",
71          "nearest_city": "Los Angeles"
72        },
73        "to": {
74          "name": "Charles de Gaulle International Airport",
75          "state": "Ile-de-France",
76          "country": "France",
77          "country_code": "FR",
78          "locode": null,
79          "iata_code": "CDG",
80          "icao_code": "LFPG",
81          "lat": 49.0127983093,
82          "lng": 2.5499999523,
83          "timezone": "Europe/Paris",
84          "nearest_city": "Paris"
85        },
86        "transport_type": "PLANE",
87        "departure_datetime_local": {
88          "estimated": "2023-12-29 15:25:00",
89          "actual": "2023-12-29 15:18:00"
90        },
91        "arrival_datetime_local": {
92          "estimated": "2023-12-30 11:15:00",
93          "actual": "2023-12-30 11:30:00"
94        },
95        "piece": 2,
96        "weight": 25,
97        "flight_number": "AF0065",
98        "path": []
99      },
100      {
101        "order_id": 2,
102        "status": "ARRIVED",
103        "from": {
104          "name": "Charles de Gaulle International Airport",
105          "state": "Ile-de-France",
106          "country": "France",
107          "country_code": "FR",
108          "locode": null,
109          "iata_code": "CDG",
110          "icao_code": "LFPG",
111          "lat": 49.0127983093,
112          "lng": 2.5499999523,
113          "timezone": "Europe/Paris",
114          "nearest_city": "Paris"
115        },
116        "to": {
117          "name": "Toulouse-Blagnac Airport",
118          "state": "Occitanie",
119          "country": "France",
120          "country_code": "FR",
121          "locode": null,
122          "iata_code": "TLS",
123          "icao_code": "LFBO",
124          "lat": 43.6291007996,
125          "lng": 1.3638199568,
126          "timezone": "Europe/Paris",
127          "nearest_city": "Toulouse/Blagnac"
128        },
129        "transport_type": "TRUCK",
130        "departure_datetime_local": {
131          "estimated": "2024-01-01 20:00:00",
132          "actual": "2024-01-01 20:09:00"
133        },
134        "arrival_datetime_local": {
135          "estimated": "2024-01-02 08:00:00",
136          "actual": "2024-01-02 06:30:00"
137        },
138        "piece": 2,
139        "weight": 25,
140        "flight_number": "AF0200D",
141        "path": []
142      }
143    ],
144    "events": [
145      {
146        "order_id": 1,
147        "event_code": "BKD",
148        "description": "Booked",
149        "location": {
150          "name": "Los Angeles International Airport",
151          "state": "California",
152          "country": "United States",
153          "country_code": "US",
154          "locode": null,
155          "iata_code": "LAX",
156          "icao_code": "KLAX",
157          "lat": 33.9424963888889,
158          "lng": -118.408048611111,
159          "timezone": "America/Los_Angeles",
160          "nearest_city": "Los Angeles"
161        },
162        "datetime_local": {
163          "estimated": null,
164          "actual": "2023-12-28 14:27:25"
165        },
166        "piece": 2,
167        "weight": 25,
168        "flight_number": null
169      },
170      {
171        "order_id": 2,
172        "event_code": "FWB",
173        "description": "FWB processed",
174        "location": {
175          "name": "Los Angeles International Airport",
176          "state": "California",
177          "country": "United States",
178          "country_code": "US",
179          "locode": null,
180          "iata_code": "LAX",
181          "icao_code": "KLAX",
182          "lat": 33.9424963888889,
183          "lng": -118.408048611111,
184          "timezone": "America/Los_Angeles",
185          "nearest_city": "Los Angeles"
186        },
187        "datetime_local": {
188          "estimated": null,
189          "actual": "2023-12-28 12:32:00"
190        },
191        "piece": 2,
192        "weight": 25,
193        "flight_number": null
194      },
195      {
196        "order_id": 3,
197        "event_code": "FOH",
198        "description": "Freight on hand",
199        "location": {
200          "name": "Los Angeles International Airport",
201          "state": "California",
202          "country": "United States",
203          "country_code": "US",
204          "locode": null,
205          "iata_code": "LAX",
206          "icao_code": "KLAX",
207          "lat": 33.9424963888889,
208          "lng": -118.408048611111,
209          "timezone": "America/Los_Angeles",
210          "nearest_city": "Los Angeles"
211        },
212        "datetime_local": {
213          "estimated": null,
214          "actual": "2023-12-29 11:00:00"
215        },
216        "piece": 2,
217        "weight": 25,
218        "flight_number": null
219      },
220      {
221        "order_id": 4,
222        "event_code": "RCS",
223        "description": "Received from shipper",
224        "location": {
225          "name": "Los Angeles International Airport",
226          "state": "California",
227          "country": "United States",
228          "country_code": "US",
229          "locode": null,
230          "iata_code": "LAX",
231          "icao_code": "KLAX",
232          "lat": 33.9424963888889,
233          "lng": -118.408048611111,
234          "timezone": "America/Los_Angeles",
235          "nearest_city": "Los Angeles"
236        },
237        "datetime_local": {
238          "estimated": null,
239          "actual": "2023-12-29 13:04:00"
240        },
241        "piece": 2,
242        "weight": 25,
243        "flight_number": null
244      },
245      {
246        "order_id": 5,
247        "event_code": "DEP",
248        "description": "Departed",
249        "location": {
250          "name": "Los Angeles International Airport",
251          "state": "California",
252          "country": "United States",
253          "country_code": "US",
254          "locode": null,
255          "iata_code": "LAX",
256          "icao_code": "KLAX",
257          "lat": 33.9424963888889,
258          "lng": -118.408048611111,
259          "timezone": "America/Los_Angeles",
260          "nearest_city": "Los Angeles"
261        },
262        "datetime_local": {
263          "estimated": null,
264          "actual": "2023-12-29 15:18:00"
265        },
266        "piece": 2,
267        "weight": 25,
268        "flight_number": "AF0065"
269      },
270      {
271        "order_id": 6,
272        "event_code": "ARR",
273        "description": "Arrived",
274        "location": {
275          "name": "Charles de Gaulle International Airport",
276          "state": "Ile-de-France",
277          "country": "France",
278          "country_code": "FR",
279          "locode": null,
280          "iata_code": "CDG",
281          "icao_code": "LFPG",
282          "lat": 49.0127983093,
283          "lng": 2.5499999523,
284          "timezone": "Europe/Paris",
285          "nearest_city": "Paris"
286        },
287        "datetime_local": {
288          "estimated": null,
289          "actual": "2023-12-30 11:30:00"
290        },
291        "piece": 2,
292        "weight": 25,
293        "flight_number": "AF0065"
294      },
295      {
296        "order_id": 7,
297        "event_code": "RCF",
298        "description": "Received from flight",
299        "location": {
300          "name": "Charles de Gaulle International Airport",
301          "state": "Ile-de-France",
302          "country": "France",
303          "country_code": "FR",
304          "locode": null,
305          "iata_code": "CDG",
306          "icao_code": "LFPG",
307          "lat": 49.0127983093,
308          "lng": 2.5499999523,
309          "timezone": "Europe/Paris",
310          "nearest_city": "Paris"
311        },
312        "datetime_local": {
313          "estimated": null,
314          "actual": "2023-12-30 16:07:00"
315        },
316        "piece": 2,
317        "weight": 25,
318        "flight_number": "AF0065"
319      },
320      {
321        "order_id": 8,
322        "event_code": "DEP",
323        "description": "Departed",
324        "location": {
325          "name": "Charles de Gaulle International Airport",
326          "state": "Ile-de-France",
327          "country": "France",
328          "country_code": "FR",
329          "locode": null,
330          "iata_code": "CDG",
331          "icao_code": "LFPG",
332          "lat": 49.0127983093,
333          "lng": 2.5499999523,
334          "timezone": "Europe/Paris",
335          "nearest_city": "Paris"
336        },
337        "datetime_local": {
338          "estimated": null,
339          "actual": "2024-01-01 20:09:00"
340        },
341        "piece": 2,
342        "weight": 25,
343        "flight_number": "AF0200D"
344      },
345      {
346        "order_id": 9,
347        "event_code": "ARR",
348        "description": "Arrived",
349        "location": {
350          "name": "Toulouse-Blagnac Airport",
351          "state": "Occitanie",
352          "country": "France",
353          "country_code": "FR",
354          "locode": null,
355          "iata_code": "TLS",
356          "icao_code": "LFBO",
357          "lat": 43.6291007996,
358          "lng": 1.3638199568,
359          "timezone": "Europe/Paris",
360          "nearest_city": "Toulouse/Blagnac"
361        },
362        "datetime_local": {
363          "estimated": null,
364          "actual": "2024-01-02 06:30:00"
365        },
366        "piece": 2,
367        "weight": 25,
368        "flight_number": "AF0200D"
369      },
370      {
371        "order_id": 10,
372        "event_code": "RCF",
373        "description": "Received from flight",
374        "location": {
375          "name": "Toulouse-Blagnac Airport",
376          "state": "Occitanie",
377          "country": "France",
378          "country_code": "FR",
379          "locode": null,
380          "iata_code": "TLS",
381          "icao_code": "LFBO",
382          "lat": 43.6291007996,
383          "lng": 1.3638199568,
384          "timezone": "Europe/Paris",
385          "nearest_city": "Toulouse/Blagnac"
386        },
387        "datetime_local": {
388          "estimated": null,
389          "actual": "2024-01-02 10:02:00"
390        },
391        "piece": 2,
392        "weight": 25,
393        "flight_number": "AF0200D"
394      },
395      {
396        "order_id": 11,
397        "event_code": "NFD",
398        "description": "Notified",
399        "location": {
400          "name": "Toulouse-Blagnac Airport",
401          "state": "Occitanie",
402          "country": "France",
403          "country_code": "FR",
404          "locode": null,
405          "iata_code": "TLS",
406          "icao_code": "LFBO",
407          "lat": 43.6291007996,
408          "lng": 1.3638199568,
409          "timezone": "Europe/Paris",
410          "nearest_city": "Toulouse/Blagnac"
411        },
412        "datetime_local": {
413          "estimated": null,
414          "actual": "2024-01-02 10:02:00"
415        },
416        "piece": 2,
417        "weight": 25,
418        "flight_number": null
419      },
420      {
421        "order_id": 12,
422        "event_code": "DLV",
423        "description": "Delivered",
424        "location": {
425          "name": "Toulouse-Blagnac Airport",
426          "state": "Occitanie",
427          "country": "France",
428          "country_code": "FR",
429          "locode": null,
430          "iata_code": "TLS",
431          "icao_code": "LFBO",
432          "lat": 43.6291007996,
433          "lng": 1.3638199568,
434          "timezone": "Europe/Paris",
435          "nearest_city": "Toulouse/Blagnac"
436        },
437        "datetime_local": {
438          "estimated": null,
439          "actual": "2024-01-04 10:06:00"
440        },
441        "piece": 2,
442        "weight": 25,
443        "flight_number": null
444      }
445    ]
446  }
447}