Return a time series of events affecting each requested coordinate, keyed by event ID with a summary at each time. Use those IDs with Event Detail to retrieve geometries and the full forecast.
| Name | Description | Format |
|---|---|---|
| coordinates Required | Up to 10 semicolon-separated latitude,longitude pairs, in the same format as Point Forecast. Latitude ranges from −90 to 90; longitude from −180 to 180. | lat,lon;lat,lon;... |
| initialization_time Optional | Defaults to the latest initialization with all four event products complete. | ISO 8601, YYYYMMDDHH, or latest |
| min_forecast_time Optional | Earliest returned forecast time, inclusive. Defaults to forecast_zero. | ISO 8601 |
| max_forecast_time Optional | Latest returned forecast time, inclusive. Defaults to forecast_zero + 360 hours. | ISO 8601 |
| event_type Optional | Return only this type. Omit to include all supported types. | atmospheric_river, heatwave, coldwave, or front |
Atmospheric rivers, heatwaves, and coldwaves are included when the requested point lies within their polygon extent at that forecast hour.
A front affects a coordinate when its tracked boundary sweeps across that point between consecutive forecast hours. A crossing between FH0 and FH3 includes the front in both rows, with each hour's own summary and classifications.
The response is JSON. All timestamps are ISO 8601 UTC.
| Field | Type | Description |
|---|---|---|
| model | string | Model whose forecast output was used. |
| initialization_time | string | Selected model initialization. |
| forecast_zero | string | Valid time of FH0; can differ from initialization_time. |
| events | array of arrays | One array per requested coordinate, in request order. Each contains rows ordered by time: events[coordinate_index][time_index]. |
| [coordinate_index] | array | Forecast-time rows for one requested coordinate. |
| [time_index] | object | One row at a forecast time, ordered chronologically. |
| latitude | number | Requested latitude. |
| longitude | number | Requested longitude. |
| time | string | Forecast time represented by this row. |
| events | object | Keyed by event_id. Includes polygon events containing the coordinate and fronts whose swept area crosses it during an adjacent forecast interval. |
| [event_id] | object | One matching event, keyed by its public ID. |
| event_type | string | Type of weather event. |
| forecast_hour | integer | Hours from forecast_zero to this record's valid_time. |
| valid_time | string | Time of the atmospheric-river footprint or front boundary, or start of a heatwave or coldwave UTC map interval. |
| period_end | string | Exclusive end of a heatwave or coldwave map interval; three hours after valid_time by default. Omitted for atmospheric rivers and fronts. |
| summary | object | Overall geometry's summary for this forecast hour. Polygon events include severity, centers, area, and intensity metrics; fronts include classifications and length_km. Matches properties.summary on the overall geometry in Event Detail. |
Each returned summary describes the entire event at that forecast hour, not conditions at the requested coordinate.