: Get daily values

API: usgs.gov:usgs-water-services
Endpoint: /nwis/dv/
Response format: application/json +1 format
Charset: utf-8
Auth: unknown
Method: GET
Last Status: 200
Latency: 838ms

Description

Retrieve historical daily summary values (max, min, mean) for sites. Commonly used for streamflow, gage height, and other parameters with daily statistics.

Parameters (16)

agencyCd (string, query, optional)

Agency code

bBox (string, query, optional)

Bounding box (max 25° product)

countyCd (string, query, optional)

Five-digit FIPS county codes

endDT (string, query, optional)

End date (ISO-8601)

format (string, query, optional)

Output format

Constraints: {'enum': ['rdb', 'rdb,1.0', 'json', 'json,1.1', 'waterml', 'waterml,1.1', 'waterml,2.0']}

huc (string, query, optional)

Hydrologic unit codes

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

Pretty-print with indentation

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

modifiedSince (string, query, optional)

ISO-8601 duration for recently modified data

parameterCd (string, query, optional)

Five-digit USGS parameter codes. Max 100.

period (string, query, optional)

ISO-8601 duration. Do not use increments of less than a day.

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, optional)

Comma-separated site numbers

startDT (string, query, optional)

Start date (ISO-8601)

statCd (string, query, optional)

Statistic codes (e.g., 00001=max, 00002=min, 00003=mean)

stateCd (string, query, optional)

Two-digit USPS state code

Examples (3)

Get historical daily water data openapi-spec 
curl 'https://waterservices.usgs.gov/nwis/dv/?sites=01646500&period=P30D&statCd=00003'
import requests

resp = requests.get(
    "https://waterservices.usgs.gov/nwis/dv/",
    params={
        'sites': '01646500',
        'period': 'P30D',
        'statCd': '00003',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("usgs-water-services")
result = api.fetch("nwis/dv/", sites=01646500, period="P30D", statCd=00003)

for item in result:
    print(item)
const resp = await fetch("https://waterservices.usgs.gov/nwis/dv/?sites=01646500&period=P30D&statCd=00003");
const data = await resp.json();
Get historical daily water data probe-gate 
curl 'https://waterservices.usgs.gov/nwis/dv/?sites=01646500&period=P30D&statCd=00003&siteStatus=all&format=json'
import requests

resp = requests.get(
    "https://waterservices.usgs.gov/nwis/dv/",
    params={
        'sites': '01646500',
        'period': 'P30D',
        'statCd': '00003',
        'siteStatus': 'all',
        'format': 'json',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("usgs-water-services")
result = api.fetch("nwis/dv/", sites=01646500, period="P30D", statCd=00003, siteStatus="all", format="json")

for item in result:
    print(item)
const resp = await fetch("https://waterservices.usgs.gov/nwis/dv/?sites=01646500&period=P30D&statCd=00003&siteStatus=all&format=json");
const data = await resp.json();
Get daily values openapi-spec 
curl 'https://waterservices.usgs.gov/nwis/dv/?sites=01646500&stateCd=NY&huc=02070010&bBox=-83%2C36.5%2C-81%2C38.5&countyCd=51059&parameterCd=00060&period=P7D&format=json&modifiedSince=P1W'
import requests

resp = requests.get(
    "https://waterservices.usgs.gov/nwis/dv/",
    params={
        'sites': '01646500',
        'stateCd': 'NY',
        'huc': '02070010',
        'bBox': '-83,36.5,-81,38.5',
        'countyCd': '51059',
        'parameterCd': '00060',
        'period': 'P7D',
        'format': 'json',
        'modifiedSince': 'P1W',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("usgs-water-services")
result = api.fetch("nwis/dv/", sites=01646500, stateCd="NY", huc=02070010, bBox="-83,36.5,-81,38.5", countyCd=51059, parameterCd=00060, period="P7D", format="json", modifiedSince="P1W")

for item in result:
    print(item)
const resp = await fetch("https://waterservices.usgs.gov/nwis/dv/?sites=01646500&stateCd=NY&huc=02070010&bBox=-83%2C36.5%2C-81%2C38.5&countyCd=51059&parameterCd=00060&period=P7D&format=json&modifiedSince=P1W");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 03:31:26.388484 200 838ms
2026-04-16 02:38:04.850892 400 818ms
2026-04-16 00:14:16.429853 200 633ms
2026-04-15 03:02:00.680468 200 1027ms
2026-04-15 02:17:43.339019 200 762ms
2026-04-15 00:49:29.147433 400 738ms
2026-04-14 01:37:10.001198 400 699ms
2026-04-14 01:04:30.339271 200 638ms
2026-04-14 00:32:56.826241 200 651ms
2026-04-12 16:10:42.329231 400 961ms
2026-04-12 13:30:25.270017 200 540ms
2026-04-12 12:29:14.124753 200 836ms
2026-04-10 04:08:51.723658 200 1095ms
2026-04-10 01:35:49.294023 200 718ms
2026-04-10 00:23:17.198615 400 715ms
2026-04-09 02:44:46.421787 200 677ms
2026-04-09 02:35:51.157920 400 792ms
2026-04-09 02:29:33.513003 200 754ms
2026-03-23 09:17:50.753447 200 756ms
2026-03-23 09:02:38.759882 200 796ms
2026-03-20T03:22:41.801036 200 618ms