The Flight Labs API was built to provide a simple way of accessing global aviation data for real-time and historical flights as well as allow customers to tap into an extensive data set of airline routes and other up-to-date aviation-related information.
Quickstart
Requests to the REST API are made using a straightforward HTTP GET URL structure and responses are provided in lightweight JSON format.
Example API Request:
https://goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY
Flight Data
This endpoint is capable of bringing real-time information about a specific flight in the world and retrieving flight status information in real time.
Example API Request With Flight Number Parameter:
https://goflightlabs.com/flight?access_key=YOUR_ACCESS_KEY&flight_number=3o375
Real-Time Flights
This endpoint is capable of information about all flights in the world flights and retrieving flight status information in real-time. In order to look up real-time information about one or multiple flights.
Data is being updated every 10 minutes
Example API Request:
https://goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY
Example API Request with limit parameter:
https://goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&limit=100
Example API Request with Flight Iata parameter:
Please note that this is a Real-Time Flight. It may happen that the example does not return a response, as it is not en route. In that case, we recommend using another flight_iata.
https://goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&flightIata=BA179
Example API Request with airline Iata parameter:
https://goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&airlineIata=W8
Example API Request with departure location Iata parameter:
https://goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&depIata=MAD
Example API Request with arrival location Iata parameter:
https://goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&arrIata=GIG
HTTP GET Request Parameters:
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
limit |
[Optional] Limit value for output, integer max 10000 |
flightIata |
[Optional] Flight IATA code |
flightIcao |
[Optional] Flight ICAO code |
flightNum |
[Optional] Flight Number |
airlineIata |
[Optional] Airline IATA code |
airlineIcao |
[Optional] Airline ICAO code |
depIata |
[Optional] Departure airport IATA code |
depIcao |
[Optional] Departure airport ICAO code |
arrIata |
[Optional] Arrival airport IATA code |
arrIcao |
[Optional] Arrival airport ICAO code |
aircraftIcao |
[Optional] Aircraft ICAO code |
regNum |
[Optional] Aircraft registration number |
aircraftIcao24 |
[Optional] Aircraft ICAO24 code |
status |
[Optional] Status of the flight (started, en-route, landed, unknown) |
Example API Response:
{
"success": true,
"data": [
{
"aircraft": {
"iataCode":"B789",
"icao24":"C01040",
"icaoCode":"B789",
"regNumber":"C-FGDZ"
},
"airline": {
"iataCode":"AC",
"icaoCode":"ACA"
},
"arrival" : {
"iataCode":"GRU",
"icaoCode":"SBGR"
},
"departure" : {
"iataCode":"EZE",
"icaoCode":"SAEZ"
},
"flight" : {
"iataNumber":"AC91",
"icaoNumber":"ACA091",
"number":"91"
},
"geography" : {
"altitude":12496.8,
"direction":31.15,
"latitude":-26.98,
"longitude":-49.95
},
"speed" : {
"horizontal":880.74,
"isGround":0,
"vspeed":-1.188
},
"status":"en-route",
"system" : {
"squawk":null,
"updated":1665523076
}
},
{ ... },
]
}
API Response Objects:
Response Object | Description |
---|---|
aircraft |
Returns the aircraft data. Format: Array |
aircraft > iataCode |
Returns the IATA code. |
aircraft > icao24 |
Returns the Aircraft ICAO24 code. Example: C01040 |
aircraft > icaoCode |
Returns the ICAO code. |
aircraft > regNumber |
Returns the Aircraft registration number. |
airline |
Returns the array data. |
airline > iataCode |
Returns the IATA code Airline. |
airline > icaoCode |
Returns the ICAO code Airline. |
arrival |
Returns array data |
arrival > iataCode |
Returns the arrival airport IATA code . |
arrival > icaoCode |
Returns the arrival airport ICAO code. |
departure |
Returns array data |
departure > iataCode |
Returns the departure airport IATA code. |
departure > icaoCode |
Returns the departure airport ICAO code. |
flight |
Returns the data array. |
flight > iataNumber |
Returns the IATA Number. |
flight > icaoNumber |
Returns the ICAO Number. |
flight > number |
Returns the number of flight. |
geography |
Returns the data array. |
geography > altitude |
Returns the altitude flight. |
geography > direction |
Returns the direction flight. |
geography > latitude |
Returns the latitude flight. |
geography > longitude |
Returns the longitude flight. |
speed > horinzontal |
Returns the horizontal speed |
speed > isGround |
Returns the if is ground |
speed > vspeed |
Returns the vertical speed |
status |
Returns the status flight |
Flights with CallSign
Receive all the flights in the course right now. Receive IATA codes, current position, speed, heading, departure and arrival airports, and callsign.
Example API Request:
https://goflightlabs.com/flights-with-call-sign?access_key=YOUR_ACCESS_KEY
HTTP GET Request Parameters:
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
Example API Response:
{
"success": true,
"data": [
{
"id": "306cca05",
"icao_24bit": "ACE75A",
"latitude": 42.4041,
"longitude": -113.4729,
"heading": 60,
"altitude": 50400,
"ground_speed": 18,
"squawk": "N/A",
"aircraft_code": "BALL",
"registration": "N930TH",
"time": 1686858538,
"origin_airport_iata": "N/A",
"destination_airport_iata": "N/A",
"number": "N/A",
"airline_iata": "N/A",
"on_ground": 0,
"vertical_speed": 128,
"callsign": "HBAL628",
"airline_icao": "N/A"
},
{...}
]
}
API Response Objects:
Response Object | Description |
---|---|
id |
Return the ID of the flight in the JSON response. This ID is unique for every flight in the response. |
icao_24bit |
Return the unique 24-bit identifier of the aircraft concerned. |
latitude |
Return the latitude position of the aircraft. |
longitude |
Return the longitude position of the aircraft. |
heading |
Return the direction on which the aircraft is heading. |
altitude |
Return the distance to the ground in Meters. |
ground_speed |
Return the ground speed expressed in knots. |
squawk |
Return the squawk codes are what air traffic control (ATC) use to identify aircraft when they are flying. |
aircraft_code |
An aircraft registration is a code unique to a single aircraft, required by international convention to be marked on the exterior of every civil aircraft. The registration indicates the aircraft's country of registration, and functions much like an automobile license plate or a ship registration. |
registration |
An aircraft registration is a code unique to a single aircraft, required by international convention to be marked on the exterior of every civil aircraft. The registration indicates the aircraft's country of registration, and functions much like an automobile license plate or a ship registration. |
time |
Return the UNIX timestamp for when the information is given. |
origin_airport_iata |
Return the IATA code of the departure airport. |
destination_airport_iata |
Return the IATA code of the arrival airpot. |
number |
Return the flight number. |
airline_iata |
Return the IATA code of the airline. |
on_ground |
Result "0" if the plane is flying. Result "1" if the plane is on the ground. |
vertical_speed |
Return the vertical speed expressed on knots. |
callsign |
A callsign is like an airplane's name during a particular flight. |
airline_icao |
Return the ICAO code of the airline. |
Flights by Airline
Get all the active flights based on the IATA code of any airline.
Example API Request:
https://goflightlabs.com/flights-by-airline?access_key=YOUR_ACCESS_KEY&airline_icao=AZU
HTTP GET Request Parameters:
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
airline_icao |
[Required] Airline ICAO code. |
Example API Response:
{
"success": true,
"data": [
{
"id": "30bcc423",
"icao_24bit": "E496F0",
"latitude": 47.6747,
"longitude": 1.2025,
"heading": 23,
"altitude": 18800,
"ground_speed": 369,
"squawk": "N/A",
"aircraft_code": "A359",
"registration": "PR-AOY",
"time": 1686918290,
"origin_airport_iata": "VCP",
"destination_airport_iata": "ORY",
"number": "AD8700",
"airline_iata": "AD",
"on_ground": 0,
"vertical_speed": -1472,
"callsign": "AZU8700",
"airline_icao": "AZU"
},
{...}
]
}
API Response Objects:
Response Object | Description |
---|---|
id |
Return the ID of the flight in the JSON response. This ID is unique for every flight in the response. |
icao_24bit |
Return the unique 24-bit identifier of the aircraft concerned. |
latitude |
Return the latitude position of the aircraft. |
longitude |
Return the longitude position of the aircraft. |
heading |
Return the direction on which the aircraft is heading. |
altitude |
Return the distance to the ground in Meters. |
ground_speed |
Return the ground speed expressed in knots. |
squawk |
Return the squawk codes are what air traffic control (ATC) use to identify aircraft when they are flying. |
aircraft_code |
An aircraft registration is a code unique to a single aircraft, required by international convention to be marked on the exterior of every civil aircraft. The registration indicates the aircraft's country of registration, and functions much like an automobile license plate or a ship registration. |
registration |
An aircraft registration is a code unique to a single aircraft, required by international convention to be marked on the exterior of every civil aircraft. The registration indicates the aircraft's country of registration, and functions much like an automobile license plate or a ship registration. |
time |
Return the UNIX timestamp for when the information is given. |
origin_airport_iata |
Return the IATA code of the departure airport. |
destination_airport_iata |
Return the IATA code of the arrival airpot. |
number |
Return the flight number. |
airline_iata |
Return the IATA code of the airline. |
on_ground |
Result "0" if the plane is flying. Result "1" if the plane is on the ground. |
vertical_speed |
Return the vertical speed expressed on knots. |
callsign |
A callsign is like an airplane's name during a particular flight. |
airline_icao |
Return the ICAO code of the airline. |