--- title: "Weather-Disruption-Risk index at a point or airport (Sugra derived)" method: GET path: "/api/v2/transport/disruption-risk" tags: ["Transportation"] --- # Weather-Disruption-Risk index at a point or airport (Sugra derived) `GET /api/v2/transport/disruption-risk` 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. ## Query parameters - `lat` number, nullable — Latitude, decimal degrees. - `lon` number, nullable — Longitude, decimal degrees. - `airport` string, nullable — ICAO or IATA airport code to score instead of a coordinate, e.g. KJFK or JFK. ## Response `200` Successful Response - EnvelopeDisruptionRiskFeed - `data` DisruptionRiskFeed, required - `location` DisruptionLocation, required - `requested` DisruptionRequestedLocation, required - `lat` number, nullable - `lon` number, nullable - `airport` string, nullable - `resolved` DisruptionResolvedLocation, required - `lat` number, required - `lon` number, required — Longitude normalized to [-180, 180). - `method` string, required — How the coordinate was resolved: coordinates | airport_metar | airport_catalog. - `airport` DisruptionAirport - `code` string, required — The airport code as resolved, upper-cased. - `name` string, nullable — Airport name; null when the code was matched against a current report. - `source` string, required — Where the coordinate came from: noaa-awc-metar | ourairports. - `tile` string, required — The 10-degree spine tile that covers the coordinate. - `index` number, required — Weather-Disruption-Risk index, 0-100. - `band` string, required — low | moderate | high | severe. - `dominant_driver` string, required — The factor that set the floor of the index. - `components_used` string[] — Factors that could be evaluated, sorted. - `components_count` integer, required - `factors` DisruptionFactors, required - `flight_category` FlightCategoryFactor - `score` number, required — Factor sub-score, 0-100. - `category` string, required — NOAA flight category: VFR | MVFR | IFR | LIFR. - `derivation` string, required — noaa-awc when the category was reported by the source, sugra-computed when Sugra derived it from ceiling and visibility. - `station` string, nullable — Reporting station the category came from. - `distance_km` number, nullable — Great-circle distance to that station. - `observed_at` string, nullable - `visibility_mi` string, nullable — Reported visibility, statute miles (a string). - `ceiling_ft` integer, nullable — Lowest broken/overcast base, feet AGL. - `wind` WindFactor - `score` number, required - `wind_speed_kt` number, required — Sustained 10 m wind, knots. - `wind_speed_ms` number, required — The same wind in the spine's native metres per second. - `cycle` string, nullable — Spine cycle the wind was sampled from. - `gust` GustFactor - `score` number, required - `wind_gust_kt` number, required — 10 m wind gust, knots. - `gust_spread_kt` number, nullable — Gust minus sustained wind, knots; drives the spread bonus. - `precipitation` PrecipitationFactor - `score` number, required - `rate_mm_h` number, nullable — Precipitation rate, millimetres per hour. - `observed_at` string, nullable - `convection` ConvectionFactor - `score` number, required - `advisory` ConvectiveAdvisoryRef - `advisory_type` string, nullable - `hazard` string, nullable - `valid_from` string, nullable - `valid_to` string, nullable - `distance_km` number, nullable — 0 when the point falls inside the advisory polygon; otherwise the distance to the advisory centroid. - `lightning_flashes` integer, nullable — Flashes inside the lightning radius; null outside the lightning field of view or when the feed was unreadable. - `lightning_radius_km` number, required - `wave` WaveFactor - `score` number, required - `wave_height_m` number, nullable — Significant height of combined wind waves and swell, metres. - `wave_period_s` number, nullable — Primary wave mean period, seconds. - `hazard_overlay` HazardOverlayFactor - `score` number, required — Highest decayed hazard score at the point. - `events` HazardOverlayEvent[] — Only events that scored above zero, worst first. - `event_type` string, required - `event_id` string, nullable - `place` string, nullable - `severity` string, nullable — CAP severity carried by the event. - `distance_km` number, required - `influence_radius_km` number, required — Scoring influence radius for this event type. NOT an official warning area. - `score` number, required — Severity base after linear distance decay. - `feeds_read` integer, required — Hazard feeds that were readable for this response. - `feeds_total` integer, required - `unavailable_factors` object — Factor name to the reason it could not be evaluated. An absent factor is excluded from the combination, never scored as zero. - `thresholds` object — The complete published threshold set and combination formula, echoed so the index can be reproduced from the same inputs. - `methodology` string, required - `attribution` DisruptionAttribution, required - `attribution` DisruptionAttributionEntry[] — The Sugra-derived entry first (no sovereign shield), then every base source that actually contributed to this point. - `registry_key` string, required - `source_name` string, required - `licence` string, nullable - `citation` string, nullable — Modified-form citation; absent on the Sugra-derived entry itself. - `disclaimer` string, required - `effective_reexport` string, required — Most-restrictive re-export verdict across the contributing bases. - `disclaimer` string, required - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope. - `endpoint` string, required — Requested endpoint path. - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request. - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced. - `provider` string, required — API name and version. - `source` string, nullable — Identifier of the primary upstream source used for this response. - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response. - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data. - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried. - `cached` boolean, nullable — True when this response was served from the internal cache. - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data. ## Other responses - `401` — Missing or invalid `x-api-key` header. - `422` — Validation Error - `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window. - `503` — Upstream source is temporarily unavailable. Retry after a short delay. --- [API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/versions/dcf7427e6897/schema)