Describe this server, its limits, common codes, and supported collections.

Show whether local caching is enabled, its location, size, and TTL policy.

Calculate local and UTC solar events using an IANA timezone.

When tz is omitted, the timezone is resolved locally from the point. date is an ISO date and defaults to today in that timezone.

Get active NWS watches, warnings, and advisories for a point.

Check this first for flood and severe-weather safety questions. An empty successful result explicitly means NWS reports no active alerts there.

Get the NWS multi-period forecast for a latitude and longitude.

Get 1-168 hours of NWS forecast data with hourly precipitation odds.

Get the latest raw NWS Area Forecast Discussion for a three-letter WFO.

Resolve a point to its NWS office, grid, forecast zone, county, and fire zone.

Find nearest active gauges with a latest reading, sorted by distance.

Coordinates are WGS84 decimal degrees. The default parameter 00060 finds streamflow gauges; use 00065 for gage height or 00010 for water temperature.

Search monitoring locations by a case-insensitive partial name.

state accepts a full name, two-letter postal abbreviation, or FIPS code.

Get the latest streamflow/discharge (parameter 00060) for a USGS site.

Compare current discharge with the median and percentiles for this date.

as_of optionally selects the comparison day using an ISO date. Current discharge remains the latest observation. Sites without normal statistics return current flow with a null ratio and a plain-language explanation. When ratio_reliable is false, use flow_state and percentile_bucket instead of ranking by the raw ratio.

Compare current discharge with date normals for 1-25 USGS sites.

Duplicate site IDs are removed while preserving input order. as_of optionally selects the comparison day using an ISO date; current discharge remains the latest observation. The records use the same fields and reliability guidance as get_flow_anomaly. If individual upstream requests fail, successful records remain available and structured failures are reported in metadata.errors; partial responses are never cached.

Get annual discharge peaks with all-time, seasonal, and current context.

Seasons use peak-date calendar months. By default, monsoon is July through September and cool season is the complementary October-through-June span. A seasonal peak is the largest annual peak whose date falls in that season, not the maximum flow observed during the season each year: a year whose annual peak was a winter flood contributes nothing to the monsoon figure even if it also had a large summer pulse. Treat it as informational scale, not a safety threshold.

Get mean daily streamflow (parameter 00060, statistic 00003).

start and end are ISO dates such as 2025-01-01.

Get the latest gage height/water level (parameter 00065) for a site.

Detect whether one site's gage height is rising, steady, or falling.

window is an ISO 8601 duration from 15 minutes through 72 hours. The default is PT6H. Each gage-height time series is evaluated separately; the result uses the series with the greatest rise and never mixes datums.

Get latest water temperature with Celsius and Fahrenheit values.

Get current gage height and any published action/flood-stage thresholds.

Threshold availability varies by site. Values come from modern time-series metadata; this operation does not infer a threshold when none is published.

Find USGS monitoring locations by site, state, county, type, HUC, or bbox.

Discover time series, their parameters, units, availability, and IDs.

Get continuous or daily observations for one or more sites.

Get the latest continuous or daily value per matching time series.

Get discrete field measurements, metadata, channel measurements, or peaks.

Get historical summary statistics for specific monitoring locations.

Get discrete water-quality samples from the modern USGS Samples API.

Look up parameter, statistic, site-type, state, county, or other codes.

List the filterable fields and schemas for a modern OGC collection.

Delete all locally cached NWS and USGS API responses for this server.