: Get statistics

API: usgs.gov:usgs-water-services
Endpoint: /nwis/stat/
Response format: text/plain
Charset: utf-8
Auth: unknown
Method: GET
Last Status: 200
Latency: 572ms

Description

Retrieve statistical summaries (daily, monthly, or annual statistics) for sites based on approved daily-mean data.

Parameters (13)

agencyCd (string, query, optional)

Agency code

endDt (string, query, optional)

End date. Default: end of period of record.

format (string, query, optional, default: rdb)

Output format (rdb only)

Constraints: {'enum': ['rdb']}

indent (string, query, optional, default: off)

Pretty-print (currently ignored)

Constraints: {'enum': ['on', 'off']}

missingData (string, query, optional, default: off)

Calculate statistics even with gaps in data

Constraints: {'enum': ['on', 'off']}

parameterCd (string, query, optional)

Five-digit USGS parameter codes. Max 100.

siteStatus (string, query, optional, default: all)

Filter by site status

Constraints: {'enum': ['all', 'active', 'inactive']}

siteType (string, query, optional)

Site type codes

sites (string, query, required)

Comma-separated site numbers. Required. Max 10 sites.

startDt (string, query, optional)

Start date (YYYY-MM-DD, YYYY-MM, or YYYY). Default: start of period of record.

statReportType (string, query, optional, default: daily)

Statistics reporting period

Constraints: {'enum': ['daily', 'monthly', 'annual']}

statType (string, query, optional)

Type of statistic. Max 12 values.

statYearType (string, query, optional, default: calendar)

Year type for annual statistics

Constraints: {'enum': ['calendar', 'water']}

Examples (2)

Get statistical summaries openapi-spec

curl 'https://waterservices.usgs.gov/nwis/stat/?site=01646500&parameterCd=00060'

import requests

resp = requests.get(
    "https://waterservices.usgs.gov/nwis/stat/",
    params={
        'site': '01646500',
        'parameterCd': '00060',
    },
)
data = resp.json()

import zingu_apis

api = zingu_apis.api("usgs-water-services")
result = api.fetch("nwis/stat/", site=01646500, parameterCd=00060)

for item in result:
    print(item)

const resp = await fetch("https://waterservices.usgs.gov/nwis/stat/?site=01646500&parameterCd=00060");
const data = await resp.json();

Truncate

Auto Table Raw

Get statistics openapi-spec

curl 'https://waterservices.usgs.gov/nwis/stat/?sites=01646500&statType=mean&parameterCd=00060'

import requests

resp = requests.get(
    "https://waterservices.usgs.gov/nwis/stat/",
    params={
        'sites': '01646500',
        'statType': 'mean',
        'parameterCd': '00060',
    },
)
data = resp.json()

import zingu_apis

api = zingu_apis.api("usgs-water-services")
result = api.fetch("nwis/stat/", sites=01646500, statType="mean", parameterCd=00060)

for item in result:
    print(item)

const resp = await fetch("https://waterservices.usgs.gov/nwis/stat/?sites=01646500&statType=mean&parameterCd=00060");
const data = await resp.json();

Truncate

Auto Table Raw

Probe History

Latency

Status Codes

Time	Status	Latency
2026-04-16 02:20:27.767279	200	572ms
2026-04-16 00:33:09.132347	200	719ms
2026-04-15 02:43:55.355013	200	552ms
2026-04-15 01:03:33.207503	200	854ms
2026-04-14 03:19:12.689789	200	591ms
2026-04-14 01:47:05.647371	200	779ms
2026-04-12 15:01:31.646878	200	602ms
2026-04-12 13:28:05.409392	200	1100ms
2026-04-10 02:35:46.812549	200	2584ms
2026-04-10 01:14:26.430042	200	710ms
2026-04-09 03:32:09.822293	200	592ms
2026-04-09 00:45:51.846507	200	752ms
2026-03-23 10:32:20.170953	200	748ms