Return to API Services
Documentation for /json/vtec_events_byugc.py
This metadata service returns VTEC events for the given UGC.
Changelog
- 2025-01-20: Added explicit sts and ets parameters for a more explicit
- datetime range.
- 2024-07-18: Initial documentation release and migration to pydantic.
Example Requests
Get all events for IAC169 during May 2024 UTC
Get all events during 2024 for Story County, Iowa IAC169
Same request, but in CSV format
Same request, but in Excel format
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 | Response format, either json, csv, or excel |
| edate | string | End Date (midnight US Central) to end query for issuance |
| sdate | string | Start Date (midnight US Central) to start query for issuance |
| sts | string | Start timestamp (overrides sdate) for event issuance |
| ets | string | End timestamp (overrides edate) for event issuance |
| ugc | string | 6-character NWS Universal Geographic Code |