v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Transportation

Observed US air-traffic delay programs - FAA NAS Status

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

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

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

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.

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.

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.

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.

Bounding-box south edge.

max_latnumber nullable

Bounding-box north edge.

Bounding-box north edge.

min_lonnumber nullable

Bounding-box west edge.

Bounding-box west edge.

max_lonnumber nullable

Bounding-box east edge.

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.

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.

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",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}