Return to API Services
This service returns any Special Weather Statements (SPS) that included a polygon threat area.
Changelog
- 2026-02-26: Renamed top level metadata generation_time to generated_at for better consistency across IEM services.
- 2024-07-06: The sdate and edate parameters were rectified to be in the format of YYYY-mm-dd instead of YYYY/mm/dd.
Example Requests
Provide SPS metadata for those with a polygon that covered Newport, NC.
https://mesonet.agron.iastate.edu/json/sps_by_point.py?lat=34.77&lon=-76.88
Return the same, in Excel format this time and only those valid at 6z on 10 Aug 2024.
The same, but CSV this time
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 output, either json, csv, or xlsx |
| lat | number | Latitude (decimal degrees) of point of interest |
| lon | number | Longitude (decimal degrees) of point of interest |
| sdate | string | Start date of search |
| edate | string | End date of search |
| valid | string | If provided, only include events valid at this time. |