--- title: "Weather-Disruption-Risk along a corridor (Sugra derived)" method: GET path: "/api/v2/transport/disruption-risk/route" tags: ["Transportation"] --- # Weather-Disruption-Risk along a corridor (Sugra derived) `GET /api/v2/transport/disruption-risk/route` The conditions-based Weather-Disruption-Risk index sampled along a great-circle corridor between two or more waypoints, with the worst stretch called out and a separate list of the hazards and convective advisories that intersect the corridor. Waypoints are lat,lon pairs or ICAO/IATA airport codes. The corridor is a SAMPLING GEOMETRY drawn by Sugra, not an airway, sea lane, cleared track or filed route, and this is not a routing or flight-planning product. ## Query parameters - `origin` string, nullable — Start waypoint: a lat,lon pair or an ICAO/IATA airport code. - `destination` string, nullable — End waypoint: a lat,lon pair or an ICAO/IATA airport code. - `path` string, nullable — Full corridor as a semicolon-separated list of waypoints, each a lat,lon pair or an airport code, e.g. KJFK;50,-40;EGLL. Overrides origin and destination. - `samples` integer — Number of points sampled along the corridor, spaced evenly by distance. ## Response `200` Successful Response - EnvelopeDisruptionRiskRouteFeed - `data` DisruptionRiskRouteFeed, required - `corridor` RouteCorridor, required - `requested` RouteRequested, required - `origin` string, nullable - `destination` string, nullable - `path` string, nullable - `samples` integer, required - `waypoints` RouteWaypoint[] - `lat` number, required - `lon` number, required - `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. - `length_km` number, required — Total great-circle length of the corridor. - `sample_count` integer, required - `leg_count` integer, required - `summary` RouteSummary, required - `samples_scored` integer, required - `peak` RouteSampleRef, required - `sample` integer, required — Zero-based index of the sample along the corridor. - `leg` integer, nullable - `distance_km` number, required — Distance from the start of the corridor. - `lat` number, required - `lon` number, required - `index` number, required - `band` string, required - `dominant_driver` string, nullable - `worst_leg` integer, nullable - `hazards_on_corridor` integer, required - `advisories_on_corridor` integer, required - `legs` RouteLeg[] - `leg` integer, required - `from` RoutePoint, required - `lat` number, required - `lon` number, required - `to` RoutePoint, required - `lat` number, required - `lon` number, required - `length_km` number, required - `samples` integer, required — Samples that fell on this leg. - `worst` RouteSampleRef - `sample` integer, required — Zero-based index of the sample along the corridor. - `leg` integer, nullable - `distance_km` number, required — Distance from the start of the corridor. - `lat` number, required - `lon` number, required - `index` number, required - `band` string, required - `dominant_driver` string, nullable - `samples` RouteSample[] - `sample` integer, required - `leg` integer, required - `distance_km` number, required - `lat` number, required - `lon` number, required - `tile` string, required — The 10-degree spine tile this sample was read from. - `index` number, nullable — Index 0-100, or null when fewer than two factors could be evaluated at this sample. A null sample is KEPT, never dropped. - `band` string, nullable - `dominant_driver` string, nullable - `components_count` integer, required - `factors` RouteSampleFactors, 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` ForecastWindFactor - `score` number, required - `wind_speed_kt` number, required — Forecast 10 m wind, knots (knots at source). - `gust` ForecastGustFactor - `score` number, required - `wind_gust_kt` number, required - `gust_spread_kt` number, 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. Precipitation is always here: it needs one live upstream call per coordinate and a corridor cannot batch it. - `hazards_on_corridor` CorridorHazard[] — Point hazards whose influence radius reaches the corridor, measured to the nearest leg rather than to the nearest sample - a hazard sitting between two samples is still on the route. - `event_type` string, required - `event_id` string, nullable - `place` string, nullable - `severity` string, nullable - `distance_km` number, required — Great-circle distance to the nearest LEG of the corridor, with an along-track clamp to the leg endpoints. - `influence_radius_km` number, required — Scoring influence radius. NOT an official warning area. - `score` number, required - `advisories_on_corridor` CorridorAdvisory[] — Convective advisories whose polygon a leg crosses, including those no sample fell inside. - `advisory_type` string, nullable - `hazard` string, nullable - `valid_from` string, nullable - `valid_to` string, nullable - `intersects` string, required — How the corridor meets the advisory. `ring` means a leg enters, leaves or passes through the polygon - which sampling alone cannot detect. - `thresholds` object - `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/4e2740743eb4/schema)