Transportation

Weather-Disruption-Risk along a corridor (Sugra derived)

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.

get/api/v2/transport/disruption-risk/route

Query parameters

originstring nullable

Start waypoint: a lat,lon pair or an ICAO/IATA airport code.

Example:KJFK

Start waypoint: a lat,lon pair or an ICAO/IATA airport code.

destinationstring nullable

End waypoint: a lat,lon pair or an ICAO/IATA airport code.

Example:EGLL

End waypoint: a lat,lon pair or an ICAO/IATA airport code.

pathstring 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.

Example:KJFK;EGLL

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.

samplesinteger

Number of points sampled along the corridor, spaced evenly by distance.

Number of points sampled along the corridor, spaced evenly by distance.

Response

Successful Response

Example response

{
  "data": {
    "corridor": {
      "requested": {
        "origin": "KJFK",
        "destination": "EGLL",
        "path": "KJFK;50,-40;EGLL",
        "samples": 24
      },
      "waypoints": [
        {
          "lat": 40.6392,
          "lon": -73.7789,
          "airport": {
            "code": "KJFK",
            "name": "John F Kennedy International Airport",
            "source": "noaa-awc-metar"
          }
        }
      ],
      "length_km": 5539.69,
      "sample_count": 24,
      "leg_count": 1
    },
    "summary": {
      "samples_scored": 24,
      "peak": {
        "sample": 12,
        "distance_km": 2769.84,
        "lat": 52.2147,
        "lon": -41.3073,
        "index": 68.4,
        "band": "high",
        "dominant_driver": "wave"
      },
      "hazards_on_corridor": 1,
      "advisories_on_corridor": 2
    },
    "legs": [
      {
        "from": {
          "lat": 52.2147,
          "lon": -41.3073
        },
        "to": {
          "lat": 52.2147,
          "lon": -41.3073
        },
        "length_km": 5539.69,
        "samples": 24,
        "worst": {
          "sample": 12,
          "distance_km": 2769.84,
          "lat": 52.2147,
          "lon": -41.3073,
          "index": 68.4,
          "band": "high",
          "dominant_driver": "wave"
        }
      }
    ],
    "samples": [
      {
        "sample": 12,
        "distance_km": 2769.84,
        "lat": 52.2147,
        "lon": -41.3073,
        "tile": "50N_050W",
        "index": 68.4,
        "band": "high",
        "dominant_driver": "wave",
        "components_count": 5,
        "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
          },
          "gust": {
            "score": 52,
            "wind_gust_kt": 38,
            "gust_spread_kt": 13
          },
          "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
          }
        }
      }
    ],
    "hazards_on_corridor": [
      {
        "event_type": "tropical_cyclone",
        "event_id": "nhc-tc-al092026",
        "place": "Atlantic",
        "severity": "Extreme",
        "distance_km": 180.4,
        "influence_radius_km": 500,
        "score": 60.7
      }
    ],
    "advisories_on_corridor": [
      {
        "advisory_type": "SIGMET_INTL",
        "hazard": "TS",
        "valid_from": "2026-07-19T14:00:00Z",
        "valid_to": "2026-07-19T18:00:00Z",
        "intersects": "ring"
      }
    ],
    "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",
    "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).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

Changed in 3 of the 25 revisions of this API.16

    • added the optional property / to the response with the status

      response-optional-property-added

    • added the optional property / to the response with the status

      response-optional-property-added

    • added the optional property / to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • endpoint added

      endpoint-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog