JUHE API Marketplace
API Service

Global Flight

Fetches flight time details by number, providing the scheduled departure and arrival times alongside the actual times.

99.9%
Uptime
32ms
Avg Response
10K+
Daily Requests
Global Flight Response
1{
2 "code": "0",
3 "msg": "success",
4 "data": {
5 "origin": {
6 "code": "JFK",
7 "name": "John F. Kennedy International Airport",
8 "city": "New York",
9 "country": "United States"
10 },
11 "destination": {
12 "code": "LAX",
13 "name": "Los Angeles International Airport",
14 "city": "Los Angeles",
15 "country": "United States"
16 },
17 "aircraft": "Boeing 777-300ER",
18 "takeoffTimes": {
19 "scheduled": "2024-01-15T10: 30: 00Z",
20 "estimated": "2024-01-15T10: 35: 00Z",
21 "actual": "2024-01-15T10: 32: 00Z"
22 },
23 "landingTimes": {
24 "scheduled": "2024-01-15T14: 30: 00Z",
25 "estimated": "2024-01-15T14: 35: 00Z",
26 "actual": "2024-01-15T14: 32: 00Z"
27 },
28 "flightStatus": "Completed"
29 }
30}
JSON30 lines

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 in YYYY-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 an incident.
  • 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 and flight_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.

Quick Actions

Pricing

FREE
Get Started with 100 requests
No Credit Card Required
View All Plans

Key Features

Real-time Processing
High Accuracy
Low Latency
Scalable Infrastructure