v5

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

Weather-Disruption-Risk index at a point or airport (Sugra derived)

Conditions-based Weather-Disruption-Risk index (0-100 with a band) for any coordinate worldwide or any reporting airport, computed by Sugra from sovereign weather, aviation, wave and hazard surfaces. Glass-box: every factor returns its own sub-score, the dominant driver is named, and the full published threshold set is echoed so the number can be reproduced. This is NOT a delay probability - it scores how hostile the observed environment is to transport operations, and models no airline, air-traffic-control, mechanical or staffing cause.

get/api/v2/transport/disruption-risk

Query parameters

latnumber nullable

Latitude, decimal degrees.

Example:40.64

Latitude, decimal degrees.

lonnumber nullable

Longitude, decimal degrees.

Example:-73.78

Longitude, decimal degrees.

airportstring nullable

ICAO or IATA airport code to score instead of a coordinate, e.g. KJFK or JFK.

Example:KJFK

ICAO or IATA airport code to score instead of a coordinate, e.g. KJFK or JFK.

Response

Successful Response

Example response

{
  "data": {
    "location": {
      "requested": {
        "lat": 40.64,
        "lon": -73.78,
        "airport": "KJFK"
      },
      "resolved": {
        "lat": 40.6394,
        "lon": -73.7789,
        "method": "airport_metar",
        "airport": {
          "code": "KJFK",
          "name": "John F Kennedy International Airport",
          "source": "noaa-awc-metar"
        }
      },
      "tile": "40N_080W"
    },
    "index": 61.3,
    "band": "high",
    "dominant_driver": "wave",
    "components_count": 6,
    "factors": {
      "flight_category": {
        "score": 75,
        "category": "IFR",
        "derivation": "noaa-awc",
        "station": "KJFK",
        "distance_km": 3.1,
        "observed_at": "2026-07-19T14:51:00Z",
        "visibility_mi": "1 1/2",
        "ceiling_ft": 700
      },
      "wind": {
        "score": 35,
        "wind_speed_kt": 25,
        "wind_speed_ms": 12.86,
        "cycle": "2026071912"
      },
      "gust": {
        "score": 52,
        "wind_gust_kt": 38,
        "gust_spread_kt": 13
      },
      "precipitation": {
        "score": 25,
        "rate_mm_h": 2.5,
        "observed_at": "2026-07-19T14:00Z"
      },
      "convection": {
        "score": 80,
        "advisory": {
          "advisory_type": "SIGMET_US",
          "hazard": "CONVECTIVE",
          "valid_from": "2026-07-19T14:00:00Z",
          "valid_to": "2026-07-19T18:00:00Z"
        },
        "lightning_flashes": 7,
        "lightning_radius_km": 25
      },
      "wave": {
        "score": 55,
        "wave_height_m": 2.5,
        "wave_period_s": 7.4
      },
      "hazard_overlay": {
        "score": 47.5,
        "events": [
          {
            "event_type": "tropical_cyclone",
            "event_id": "nhc-tc-al092026",
            "place": "Atlantic",
            "severity": "Extreme",
            "distance_km": 250,
            "influence_radius_km": 500,
            "score": 47.5
          }
        ],
        "feeds_read": 3,
        "feeds_total": 3
      }
    },
    "attribution": {
      "attribution": [
        {
          "registry_key": "sugra/disruption-risk",
          "source_name": "Sugra (computed)",
          "licence": "public-domain"
        }
      ],
      "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"
    ]
  }
}