Global Flight
Fetches flight time details by number, providing the scheduled departure and arrival times alongside the actual times.
API Introduction
About this API
The Global Flight API is a service that provides real-time and historical information for global flights. Its function is to retrieve detailed data for a specific flight when queried by its flight number. The service returns comprehensive flight information, which includes the flight's current status (e.g., scheduled, active, landed), its real-time position, and any known delay status. It is designed for applications that need to track the status and details of a known flight by using its unique flight identifier.
Key Features
- Flight Number Lookup: The primary function is to query a flight using its flight number. This can be the number itself, the full IATA code (e.g., "AA1004"), or the ICAO code.
- Date-Specific Query: The flight search can be narrowed down to a specific day by using the optional
flight_date
parameter inYYYY-MM-DD
format. - Comprehensive Flight Status: The API returns detailed status information for a flight, indicating whether it is
scheduled
,active
,landed
,cancelled
,diverted
, or involved in anincident
. - Structured JSON Output: All retrieved flight information is delivered in a structured JSON format for straightforward integration into other applications.
Use Cases
Scenario 1: Add a Flight Status Widget to a Website
- Situation: A hotel website wants to offer a simple tool for guests to check the status of their upcoming flight.
- Implementation: The website's front end provides input fields for a flight number and a date. The backend system sends these details to the API using the
flight_iata
andflight_date
parameters. The API returns the current flight status (e.g., "active," "landed"), which is then displayed on the website for the guest.
Scenario 2: Automate Logistics Notifications
- Situation: A logistics company needs to be notified when a specific cargo shipment's flight has landed to schedule ground crew.
- Implementation: An internal system is programmed to periodically call the API with the flight number and date for an expected shipment. The system monitors the
flight_status
field in the API's response. When the status changes from "active" to "landed," it automatically triggers a notification to the ground team to proceed with pickup.
Scenario 3: Build a Simple Flight Alert Service
- Situation: A developer wants to create an application that notifies a user when a friend's or family member's flight has departed and when it has arrived.
- Implementation: The application's backend stores the user-provided flight number and date. It makes scheduled calls to the API to check the flight's status. When the API response shows the
flight_status
has changed to "active," the application sends a "Flight Departed" alert. When the status updates to "landed," it sends a "Flight Arrived" alert.