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://app.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://app.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://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY

Example API Request with limit parameter:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&limit=100

Example API Request with Flight Iata parameter:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&flightIata=BA179

Example API Request with airline Iata parameter:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&airlineIata=W8

Example API Request with departure location Iata parameter:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&depIata=MAD

Example API Request with arrival location Iata parameter:

https://app.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://app.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://app.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.