Return to API Services
Changelog
- 2024-08-14: Initital documentation update and pydantic validation
Example Requests
Get all Iowa events for 2024 in JSON, then CSV, then XLSX format.
https://mesonet.agron.iastate.edu/json/vtec_events_bystate.py?state=IA&year=2024
https://mesonet.agron.iastate.edu/json/vtec_events_bystate.py?state=IA&year=2024&fmt=csv
https://mesonet.agron.iastate.edu/json/vtec_events_bystate.py?state=IA&year=2024&fmt=xlsx
Get all Tornado Warnings for Iowa during 2024.
CGI Arguments
The following table lists the CGI arguments that are accepted by this service. A HTTP GET request is required. Fields of type Multi-Params or CSV value can accept either a comma separated list or multiple parameter and value combinations. For example, ?foo=1&foo=2 is equivalent to ?foo=1,2.
| Field | Type | Description |
|---|---|---|
| callback | string or null | Legacy JSON-P style callback. It is likely best to not depend on this usage. The IEM website has a permissive CORS. |
| fmt | string | The format of the response, json, csv, or xlsx |
| phenomena | string | 2 character phenomena identifier |
| significance | string | 1 character significance identifier |
| state | string (required) | Two letter (uppercase) United States code |
| year | integer (required) | Year between 1986 and the current year for which the IEM database may have VTEC records. |