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"). |