Return to API Services.
Documentation for /json/outlook_progression.py
This service requires a latitude and longitude point along with a date of interest. The service will return the coincident SPC or WPC outlooks valid for that date.
Implementation Notes
- In the case of hatching, two entries are returned per outlook per category.
- Off cycle outlook updates are encoded as cycle=-1.
- An attempt is made at the null / no outlook situation, but it is not perfect.
Changelog
- 2026-02-26: Renamed top level generation_time metadata to generated_at for better IEM app consistency.
- 2024-11-26: Initial implementation
Example Usage
Provide the progression of convective outlooks for a point on 5 August 2024:
Same request, but return an Excel file:
Same request, but return a CSV file:
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 to return data in: json, excel, or csv |
| lat | number | Latitude (decimal degrees) of point of interest |
| lon | number | Longitude (decimal degrees) of point of interest |
| outlook_type | string | Outlook type (C)onvective, (F)ire, (E)xcessive Rain |
| valid | string (required) | Date of interest in YYYY-MM-DD format |