IEM API Mainpage

Documentation on /cgi-bin/request/hads.py

The backend database for this application has many billion rows of data, so requests can be slow.

Changelog

  • 2024-04-18: Allowed cross-year requests, but limited to 365 days when requesting more than one station.
  • 2024-04-09: Migrated to pydantic based CGI field validation.
  • 2024-03-15: Initial documentation added

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
delim string Delimiter for output
ets string End Time for request
network string or null IEM network identifier. Typically a combination of a US state abbreviation and a network classification, ie IA_ASOS.
stations Multi-Params or CSV value (required) Station Identifier(s)
sts string Start Time for request
threshold number or null Threshold Value for Searching
thresholdvar string Threshold Variable for Searching
what string Output format
year integer Legacy year value when this service only supported 1 year at a time.
year1 integer or null Start year for request, when sts not set.
year2 integer or null End year for request, when ets not set.
month1 integer Start month for request, when sts not set.
month2 integer End month for request, when ets not set.
day1 integer Start day for request, when sts not set.
day2 integer End day for request, when ets not set.
hour1 integer Start hour for request, when sts not set.
hour2 integer End hour for request, when ets not set.
minute1 integer Start minute for request, when sts not set.
minute2 integer End minute for request, when ets not set.