Return to API Services
Documentation for /geojson/sbw.geojson
This service supports a number of legacy systems and implements a number of different calling methods. The API service is recommended for new applications.
Changelog
- 2026-04-10: Corrected bug with service not providing SBWs issued at the requested timestamp when using the ts parameter.
- 2026-02-24: For IEM consistency, the generation_time root attribute was renamed generated_at.
- 2025-05-29: Implemented a states parameter to limit results to a list of given two-letter state identifiers.
- 2024-12-31: Five additional metadata fields are added with lifetime max values for windtag, hailtag, is_pds, is_emergency, and floodtag_damage. These fields are prefixed with max_.
- 2024-12-30: Parameters sts and ets can now be provided as ISO8601 formatted strings. The legacy format of %Y%m%d%H%M is still supported, but discouraged.
- 2024-11-19: Trimmed caching time from 60s to 15s. Added ps attribute that holds the VTEC Phenomena and Significance string.
Examples
Provide all SBW polygons active at a given timestamp:
https://mesonet.agron.iastate.edu/geojson/sbw.geojson?ts=2024-05-26T20:00:00Z
Provide all SBW polygons on 26 May 2024 CDT.
Provide all SBW polygons on 26 May 2025 CDF for Iowa.
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. |
| ets | string or null | UTC end timestamp parameter |
| states | array or null | Either provide a single value, multiple parameters each with a single value, or a comma-separated list of values. The context here is a list of state identifiers. All lowercase letters are converted to uppercase. |
| sts | string or null | UTC start timestamp parameter |
| ts | string | If sts and ets are not provided, this is the timestamp to request data for. |
| wfo | string | Optional WFO identifier |
| wfos | Multi-Params or CSV value | Optional list of WFOs to limit the results to |