FlightLabs API - Flight Data by Date

Flight Data by Date


This endpoint is capable of bringing real-time information about a specific flight in the world and retrieving flight status information in real time. Note that the date range must not span more than 14 days per API call.

Example API Request With Flight Number Parameter:

https://goflightlabs.com/v2/flight? access_key=YOUR_ACCESS_KEY&search_by=number&flight_number=LH811&date_from=&date_to=


HTTP GET Request Parameters:

Parameter Requirement Description
access_key Required Your API access key, which can be found in your account dashboard.
search_by Required Defines the search method. Must be one of the following values: number, callsign, reg, or icao24.
flight_number Required (if "search_by" = "number") Flight number. Example: 3O375.
callsign Required (if "search_by" = "callsign") Flight callsign. Example: DLH400.
reg Required (if "search_by" = "reg") Aircraft registration number. Example: G-EUOH.
icao24 Required (if "search_by" = "icao24") Unique ICAO24 transponder code. Example: 3c675a.
date_from Required Start date of the search in YYYY-MM-DD format. Example: 2025-01-01.
date_to Required End date of the search in YYYY-MM-DD format. Example: 2025-01-15.

Example API Response:

            
            {
                "success": true,
                "data": [
                    {
                        "greatCircleDistance": {
                            "meter": 884468.95,
                            "km": 884.47,
                            "mile": 549.58,
                            "nm": 477.58,
                            "feet": 2901801.02
                        },
                        "departure": {
                            "airport": {
                                "icao": "ESGG",
                                "iata": "GOT",
                                "name": "Goteborg Gothenburg-Landvetter",
                                "shortName": "Gothenburg-Landvetter",
                                "municipalityName": "Goteborg",
                                "location": {
                                    "lat": 57.6628,
                                    "lon": 12.2798
                                },
                                "countryCode": "SE",
                                "timeZone": "Europe/Stockholm"
                            },
                            "scheduledTime": {
                                "utc": "2025-03-28 11:00Z",
                                "local": "2025-03-28 12:00+01:00"
                            },
                            "revisedTime": {
                                "utc": "2025-03-28 10:54Z",
                                "local": "2025-03-28 11:54+01:00"
                            },
                            "runwayTime": {
                                "utc": "2025-03-28 11:03Z",
                                "local": "2025-03-28 12:03+01:00"
                            },
                            "terminal": "1",
                            "checkInDesk": "32-42",
                            "gate": "16",
                            "quality": [
                                "Basic",
                                "Live"
                            ]
                        },
                        "arrival": {
                            "airport": {
                                "icao": "EDDF",
                                "iata": "FRA",
                                "name": "Frankfurt-am-Main",
                                "shortName": "Frankfurt-am-Main",
                                "municipalityName": "Frankfurt-am-Main",
                                "location": {
                                    "lat": 50.0264,
                                    "lon": 8.543129
                                },
                                "countryCode": "DE",
                                "timeZone": "Europe/Berlin"
                            },
                            "scheduledTime": {
                                "utc": "2025-03-28 12:45Z",
                                "local": "2025-03-28 13:45+01:00"
                            },
                            "revisedTime": {
                                "utc": "2025-03-28 12:28Z",
                                "local": "2025-03-28 13:28+01:00"
                            },
                            "terminal": "1",
                            "gate": "A2",
                            "quality": [
                                "Basic",
                                "Live"
                            ]
                        },
                        "lastUpdatedUtc": "2025-03-28 12:38Z",
                        "number": "LH 811",
                        "callSign": "DLH811",
                        "status": "Arrived",
                        "codeshareStatus": "IsOperator",
                        "isCargo": false,
                        "aircraft": {
                            "reg": "D-AINY",
                            "modeS": "3C65D9",
                            "model": "Airbus A320 NEO"
                        },
                        "airline": {
                            "name": "Lufthansa",
                            "iata": "LH",
                            "icao": "DLH"
                        }
                    },
                    {...}
                ]
            }
            
        

API Response Objects:

Response Object Description
greatCircleDistance Object containing distance information in various units (e.g., meters, kilometers, miles, nautical miles, feet).
departure Object containing departure details, including airport information, scheduled/revised/runway times, terminal, check-in desk, gate, and quality indicators.
arrival Object containing arrival details, including airport information, scheduled/revised times, terminal, gate, and quality indicators.
lastUpdatedUtc UTC timestamp of the last update for the flight information.
number Flight number (e.g., "LH 811").
callSign Flight call sign (e.g., "DLH811").
status Current flight status (e.g., "Arrived").
codeshareStatus Indicates codeshare status (e.g., "IsOperator").
isCargo Boolean indicating whether the flight is a cargo flight.
aircraft Object containing aircraft details, including registration, modeS code, and model (e.g., "Airbus A320 NEO").
airline Object containing airline details, including name, IATA, and ICAO codes (e.g., "Lufthansa").