List events of the requested type across all published model runs, with optional filters for time and location. Each event appears once, with its forecast start and end times and latest available initialization.
| Name | Description |
|---|---|
| event_type Required | atmospheric_river, heatwave, coldwave, or front. The front type includes cold, warm, stationary, and occluded fronts. |
| Name | Description | Format |
|---|---|---|
| min_time Optional | Include events with a published forecast ending at or after this time. | ISO 8601 or YYYYMMDDHH |
| max_time Optional | Include events with a published forecast starting at or before this time. | ISO 8601 or YYYYMMDDHH |
| min_latitude Optional | Southern edge of the bounding box. | number, −90 to 90 |
| max_latitude Optional | Northern edge of the bounding box. | number, −90 to 90 |
| min_longitude Optional | Western edge of the bounding box. | number, −180 to 180 |
| max_longitude Optional | Eastern edge of the bounding box. | number, −180 to 180 |
| page Optional | Zero-indexed page number. Defaults to 0. | integer ≥ 0 |
| page_size Optional | Defaults to 64; maximum 500. | integer 1–500 |
| Field | Type | Description |
|---|---|---|
| model | string | Model whose forecast output was used. |
| events | object | Catalog entries keyed by event_id. |
| event_id | string | ID linking forecasts of the same weather event across model runs. |
| event_type | string | Requested event type. |
| start_time | string | Earliest forecast start across this event's published runs, in ISO 8601 UTC. |
| end_time | string | Latest forecast end across this event's published runs, in ISO 8601 UTC. |
| latest_init_time | string | Most recent initialization containing this event, in ISO 8601 UTC. |
| total | integer | Distinct events matching all filters, counted before pagination. |
| page | integer | Returned page number. |
| page_size | integer | Requested page size. |