Transportation

Observed US air-traffic delay programs - FAA NAS Status

Changed on

The ground stops, ground delay programs, airport closures, arrival and departure delays and de-icing programs the FAA currently has in force across the United States National Airspace System, each with the FAA's verbatim reason plus a Sugra classification of that free text onto a published vocabulary (weather, runway, volume, equipment, staffing, security). Filter by airport, event type, reason class, delay length and bounding box. This is OBSERVED delay, reported alongside the conditions-based Weather-Disruption-Risk index and never blended into it. United States only; consultative and not a substitute for an official preflight briefing, ATC or your airline.

get/api/v2/transport/aviation/delays

Request

Query parameters

airportsstring nullable

Comma-separated airport codes. Either the FAA three-letter identifier (JFK) or the four-letter US ICAO form (KJFK), which is normalized to it.

Example:JFK,ORD
type'ground_stop' | 'ground_delay' | 'airport_closure' | 'notam' | 'arrival_delay' | 'departure_delay' | 'deicing' nullable

Keep only events of this program type. Asking for notam opts into them regardless of include_notams.

reason_class'weather' | 'runway' | 'volume' | 'equipment' | 'staffing' | 'security' | 'other' | 'unknown' nullable

Keep only events matching this Sugra reason class. Matches ANY class the reason carries, not just the dominant one, so a runway closed for snow is found under both weather and runway.

min_delay_minutesinteger nullable

Keep only events whose upper delay bound reaches this many minutes. Events that publish no delay figure, such as most ground stops, are excluded by it.

min_latnumber nullable

Bounding-box south edge.

max_latnumber nullable

Bounding-box north edge.

min_lonnumber nullable

Bounding-box west edge.

max_lonnumber nullable

Bounding-box east edge.

include_notamsboolean

Include standing airport NOTAMs. Off by default because they are STATUS, not delay: the live feed carries multi-week notices such as an airport closed to transient general aviation except by prior permission, which would otherwise make a perfectly clear airport appear in a delay list. They are still counted in summary.by_type, so their existence is never hidden.

limitinteger

Maximum airports returned.

Response

Successful Response

Example response

{
  "data": {
    "query": {
      "airports": "JFK,ORD",
      "type": "ground_stop",
      "reason_class": "weather",
      "min_delay_minutes": 30,
      "limit": 100
    },
    "summary": {
      "airports_affected": 7,
      "events_total": 11,
      "by_type": {
        "arrival_delay": 6,
        "ground_stop": 2
      },
      "by_reason_class": {
        "volume": 3,
        "weather": 8
      }
    },
    "total_matched": 3,
    "count": 3,
    "airports": [
      {
        "airport": "JFK",
        "name": "John F. Kennedy International",
        "lat": 40.6398,
        "lon": -73.7789,
        "event_count": 2,
        "worst_delay_minutes": 61,
        "types": [
          "ground_stop",
          "arrival_delay"
        ],
        "reason_classes": [
          "weather"
        ],
        "events": [
          {
            "type": "ground_stop",
            "reason": "ZDC / VOL:Compacted Demand",
            "reason_class": "volume",
            "reason_classes": [
              "weather",
              "runway"
            ],
            "start_time": "2026-07-19T18:00:00Z",
            "end_time": "2026-07-19T21:00:00Z",
            "updated_at": "2026-07-19T17:45:00Z",
            "min_minutes": 16,
            "max_minutes": 61,
            "average_minutes": 45,
            "trend": "increasing",
            "center": "ZDC",
            "probability_of_extension": "Medium",
            "time_raw": "2:45 pm EDT"
          }
        ]
      }
    ],
    "coverage": "United States National Airspace System only.",
    "attribution": {
      "sources": [
        {
          "registry_key": "noaa/aviation-weather-center",
          "source_name": "NOAA Aviation Weather Center",
          "licence": "public-domain",
          "citation": "NOAA/NWS Aviation Weather Center (aviationweather.gov)",
          "disclaimer": "Advisory only; not a substitute for an official preflight briefing."
        }
      ],
      "effective_reexport": "allowed"
    }
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "source_url": "https://fred.stlouisfed.org/series/UNRATE",
    "citation": "Federal Reserve Bank of St. Louis (FRED) - Unemployment Rate (UNRATE) - https://fred.stlouisfed.org/series/UNRATE - retrieved 2026-11-02",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • breaking

      added subschema #1 to the response body oneOf list for the response status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    This list may be incomplete.