{{ summaryTitle }}
{{ summaryValue }}

{{ summaryLine }}

Source{{ sourceBadge }} Departure{{ departureBadge }} Arrival{{ arrivalBadge }}
{{ workflowAnnouncement }}
Flight lookup details
One IATA or ICAO flight number, such as SA101 or AAL105.
Choose the local calendar date at the departure airport.
Choose the provider represented by your live credential.
Turn this off only when you are ready to contact the selected provider.
{{ use_sample ? 'Enabled' : 'Disabled' }}
Saved only in session storage for this provider.
{{ providerHostHelp }}
On preserves the complete returned set; off removes rows identified as code-shares.
{{ include_codeshares ? 'Enabled' : 'Disabled' }}
On preserves cancelled evidence; off filters cancelled rows after normalization.
{{ include_cancelled ? 'Enabled' : 'Disabled' }}
Keep from 1 to 30 matching rows.
rows
Ordering changes which returned record is selected first; it does not rewrite provider evidence.
From 2,000 to 30,000 milliseconds.
ms
Session-only. A configured proxy can see the provider request and target.
Flight brief
{{ row.label }}
{{ row.value }}
{{ guidance.title }}

{{ guidance.action }}

Verification boundary

Compare this provider row with the airline, departure airport, or operating carrier before a time-critical connection, pickup, or rebooking decision.

{{ chartExportStatus }}

The chart renderer is unavailable. The same delay values remain in the timeline.

{{ matchesExportStatus }}
FlightRouteStatusDepartureArrivalDelaysSelectCopy
{{ row.flight_number }}{{ row.route }}{{ row.status_label }}{{ formatDateTime(row.departure, row.departure_timezone) }}{{ formatDateTime(row.arrival, row.arrival_timezone) }}{{ formatDelay(row.dep_delay_minutes) }} / {{ formatDelay(row.arr_delay_minutes) }}

A flight number identifies a published service, but it does not identify one operation by itself. The departure date and route are needed to distinguish today's flight from yesterday's arrival, an overnight service, or another leg that uses the same number. Code-share partners can also publish different flight numbers for the same physical aircraft.

Delay is a difference between a reference schedule and a later time. Departure and arrival can tell different stories: a flight may leave late and recover time, leave on time and arrive late, or be diverted or cancelled before a useful arrival estimate exists. The latest provider row is evidence to verify, not a guarantee of future operation.

Meanings of common flight time fields
TimeMeaningInterpretation
ScheduledThe published departure or arrival baselineDelay is measured from this time
EstimatedA forecast that can change before the eventUseful for planning, but not final evidence
ActualThe provider's recorded event timePreferred over estimated time when present
Provider delayA direct minute value supplied by the data sourceUsed before a timestamp-derived difference

The departure date should be the local calendar date at the origin airport. A UTC date copied from another system can select the wrong operation around midnight. Route, airline, and airport codes are therefore essential checks when several records match a number.

A delay category is not a passenger-rights decision. Rebooking, refund, compensation, connection, and airport-assistance rules depend on the operating carrier, jurisdiction, cause, itinerary, and current carrier instructions. Use provider data to organize the question, then confirm time-critical action with the airline or airport.

How to Use This Tool:

Identify one dated flight operation first, then decide whether demonstration data or a live provider is appropriate.

  1. Enter an IATA or ICAO Flight number and choose the origin airport's local Departure date.
  2. Select a Data source. Keep Use sample data on to learn the result flow; turn it off only when a valid credential for the selected provider is ready.
    A sample result is synthetic. Never use its times, route, aircraft, or status for travel.
  3. For live data, enter the provider credential. Use a custom endpoint or proxy only when it is trusted and compatible, because it can observe the request and may receive the credential.
  4. Select Check flight. If several rows return, compare airline, route, date, and airport codes in Flight matches before selecting the operation.
  5. Use Flight record for the current status and time fields, then compare departure and arrival minutes in Delay comparison. Recheck the carrier or airport before acting.

Interpreting Results:

The selected row defaults to the first retained record, with exact normalized flight-number matches moved ahead when Exact flight number first is selected. That ordering does not prove the first row is the itinerary.

  • Positive minutes mean later than schedule; negative minutes mean earlier than schedule.
  • Compare both departure and arrival. The larger absolute difference is useful for triage, while the arrival estimate usually matters most for pickup or an onward connection.
  • Cancelled and Diverted / severe delay require carrier confirmation. A missing actual arrival on an active flight is normal before landing.
  • An On time label can result when the source lacks enough timestamps to derive a delay and supplies no direct delay value. Inspect the time fields before trusting zero.

Technical Details:

A provider response is mapped into one common flight record with status, carrier, route, departure, arrival, aircraft, and code-share fields. Direct delay values are retained when available; otherwise the latest actual-or-estimated timestamp is compared with the schedule.

Formula Core

For each phase, the direct provider delay is rounded to the nearest whole minute. If it is missing, actual time is preferred over estimated time and the timestamp difference is rounded.

Δt=round ( Tlatest−Tscheduled 60000 )

Tlatest is actual time when present, otherwise estimated time. If either timestamp is unavailable and no direct provider delay exists, the normalized delay is 0 minutes. Departure and arrival are calculated separately, and displayed times use the airport time zone when the provider supplies one.

Lookup Core

Flight record retrieval and selection rules
StageRule
Flight keyUppercase the flight number and remove characters other than letters and digits.
Provider mappingNormalize AeroDataBox or AviationStack response fields into the same departure, arrival, status, route, carrier, and aircraft structure.
Row filtersOptionally remove code-share rows and cancelled rows after normalization.
Exact-first orderMove rows whose normalized flight number exactly matches the request ahead of close variants without discarding other returned rows.
Result boundKeep 1 to 30 records, with 5 as the default.

Rule Core

Status rules run in order, so an earlier match takes precedence over later delay thresholds.

Ordered flight status classification rules
OrderConditionCategory
1Raw status contains “cancel”Cancelled
2Raw status contains “divert”Diverted / severe delay
3Raw status contains “land” or “arriv”Landed
4Maximum of departure and arrival delay is ≥ 60 minutesDiverted / severe delay
5Maximum delay is ≥ 15 minutesDelayed
6Status is active, scheduled, or en route and maximum delay is > 5 minutesDelayed
7No earlier rule matchesOn time

The 15- and 60-minute boundaries are repository-authored review rules. They do not replace a provider's raw status, an airline's disruption policy, or a legal definition of delay.

Accuracy and Privacy Notes:

Live flight records can lag operations or omit times, gates, terminals, aircraft, code-share links, and cancellation detail. Every result records one retrieval time and should be checked again near the decision.

  • The provider receives the flight number, date, row limit, and relevant filter choices. It also receives the credential required by that service.
  • Credentials and proxy settings are kept in browser session storage and are excluded from the shareable settings and exported flight result.
  • A configured proxy can observe the provider request and may receive the credential. Use only a proxy you trust.
  • Provider evidence does not determine refunds, compensation, rebooking eligibility, or connection protection.

Worked Examples:

Sample flight with different phase delays

The fixed SA101 example leaves 10 minutes after schedule and is estimated to arrive 18 minutes after schedule. Because the larger value is at least 15 minutes, the record is labelled Delayed. The arrival value is the more relevant planning clue for a pickup, but the entire example remains synthetic.

References: