Returns up to the last 7 days of ASOS observations for a single station. ASOS (Automated Surface Observing Systems) are automated weather stations — primarily at airports — that report surface conditions like temperature, dewpoint, wind, pressure, and precipitation. US ASOS sites report at a 5-minute cadence; international stations follow the standard 30-minute METAR cadence.
Stations can be addressed by their 4-letter ICAO ( KDWH , EGLL ), 3-letter FAA code for US airports ( DWH ), dashed USAF-WBAN ( 722429-53910 ), or the 11-digit USAF+WBAN form ( 72242953910 ). The station catalog is sourced from NCEI's Integrated Surface Database (ISD).
| Name | Type | Description | Format |
|---|---|---|---|
| station Required | string | The station to fetch observations for. Accepts the 4-letter ICAO ( KDWH , EGLL ), 3-letter FAA code for US airports ( DWH ), dashed USAF-WBAN ( 722429-53910 ), or the 11-digit USAF+WBAN form ( 72242953910 ). Case-insensitive. | - |
| hours Optional | numeric | Lookback window in hours. Clamped to [1, 168] (7 days). Note: Defaults to 48. | integer |
| since Optional | string | If supplied, overrides hours and returns observations at or after this instant. | ISO 8601 |
| Name | Type | Description |
|---|---|---|
| station Required | string | Station identifier — 4-letter ICAO ( KDWH , EGLL ), 3-letter FAA code ( DWH ), dashed USAF-WBAN ( 722429-53910 ), or 11-digit USAF+WBAN ( 72242953910 ). |
| -H Optional | integer | Lookback window in hours, 1-168. Note: Defaults to 48. |
| -s Optional | string | ISO 8601 timestamp; overrides -H . |
| output Optional | string | Path to save the response data in .csv/.json format. |
| Name | Type | Description |
|---|---|---|
| station Required | string | Station identifier — 4-letter ICAO ( KDWH , EGLL ), 3-letter FAA code ( DWH ), dashed USAF-WBAN ( 722429-53910 ), or 11-digit USAF+WBAN ( 72242953910 ). Case-insensitive. |
| hours | integer | Lookback window in hours. Clamped to [1, 168] . Note: Defaults to 48. |
| since | string | ISO 8601 timestamp; overrides hours . |
| output_file | string | Path to save the response data in .csv/.json format. |
| print_results | boolean | If True, prints the observations as a table. |
Returns station metadata, the units used for each measurement, and an array of observations in ascending time order.
| Name | Type | Description | Format |
|---|---|---|---|
| station | object | Metadata about the resolved station. | - |
| station_id | string | The internal 11-digit USAF+WBAN form of the station id. | - |
| icao | string | The 4-letter ICAO code for the station, if known. | - |
| name | string | The human-readable name of the station (from NCEI's ISD catalog). | - |
| elevation_m | numeric | Station elevation above mean sea level. | meters |
| units | object | The unit string used for each observation field. | - |
| observations | array | An array of observation data points; see below for the data point structure. Note: Observations are sorted by time in ascending order. | - |
| time | string | The time of the observation, in UTC. | ISO 8601 (ms precision) |
| latitude | numeric | Latitude of the station at the time of the observation. | degrees |
| longitude | numeric | Longitude of the station at the time of the observation. | degrees |
| temperature_2m | numeric | Air temperature at 2 meters above ground. | °C |
| dewpoint_2m | numeric | Dewpoint temperature at 2 meters above ground. | °C |
| pressure_msl | numeric | Mean sea level pressure. Note: Null on sub-hourly (5-minute) reports — those METAR rows don't include the SLP remark group. The hourly :53Z METAR has it filled. | hPa |
| wind_u_10m | numeric | Eastward wind component at 10 meters above ground. Note: Null when the report has variable direction ( VRB ) with non-zero speed. | m/s |
| wind_v_10m | numeric | Northward wind component at 10 meters above ground. Note: Null when the report has variable direction ( VRB ) with non-zero speed. | m/s |
| precipitation | numeric | 1-hour accumulated precipitation as of time . Note: Absent values are normalized to 0.0. | mm |