v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
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",
    "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"
    ]
  }
}