: Get instantaneous values

API: usgs.gov:usgs-water-services
Endpoint: /nwis/iv/
Response format: text/html
Charset: utf-8
Auth: unknown
Method: GET
Last Status: 400
Latency: 685ms

Description

Retrieve real-time and recent historical measurements including streamflow, gage height, water temperature, and hundreds of other parameters. Data available from October 1, 2007 to present.

Parameters (15)

agencyCd (string, query, optional)

Agency code

bBox (string, query, optional)

Bounding box as 'west,south,east,north' (max 25° product)

countyCd (string, query, optional)

Five-digit FIPS county codes. Max 20.

endDT (string, query, optional)

End date/time (ISO-8601). If omitted, returns to most recent value.

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. Max 10 codes.

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

Pretty-print with indentation

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

modifiedSince (string, query, optional)

ISO-8601 duration; returns data only if values changed in period

parameterCd (string, query, optional)

Five-digit USGS parameter codes. Max 100. Common codes: 00060 (streamflow), 00065 (gage height), 00010 (water temp).

period (string, query, optional)

ISO-8601 duration from now (e.g., PT2H for 2 hours, P7D for 7 days). Mutually exclusive with startDT/endDT.

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. Max 100 sites.

startDT (string, query, optional)

Start date/time (ISO-8601). Must be before endDT.

stateCd (string, query, optional)

Two-digit USPS state code

Examples (2)

Get real-time water data openapi-spec 
curl 'https://waterservices.usgs.gov/nwis/iv/?sites=01646500%2C01646502&stateCd=ny&huc=02070008&bBox=-83%2C36.5%2C-81%2C38.5&countyCd=51059%2C51061&period=P1D&parameterCd=00060%2C00010&siteType=ST&modifiedSince=PT2H'
import requests

resp = requests.get(
    "https://waterservices.usgs.gov/nwis/iv/",
    params={
        'sites': '01646500,01646502',
        'stateCd': 'ny',
        'huc': '02070008',
        'bBox': '-83,36.5,-81,38.5',
        'countyCd': '51059,51061',
        'period': 'P1D',
        'parameterCd': '00060,00010',
        'siteType': 'ST',
        'modifiedSince': 'PT2H',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("usgs-water-services")
result = api.fetch("nwis/iv/", sites="01646500,01646502", stateCd="ny", huc=02070008, bBox="-83,36.5,-81,38.5", countyCd="51059,51061", period="P1D", parameterCd="00060,00010", siteType="ST", modifiedSince="PT2H")

for item in result:
    print(item)
const resp = await fetch("https://waterservices.usgs.gov/nwis/iv/?sites=01646500%2C01646502&stateCd=ny&huc=02070008&bBox=-83%2C36.5%2C-81%2C38.5&countyCd=51059%2C51061&period=P1D&parameterCd=00060%2C00010&siteType=ST&modifiedSince=PT2H");
const data = await resp.json();
Get instantaneous values openapi-spec 
curl 'https://waterservices.usgs.gov/nwis/iv/?sites=01646500&stateCd=NY&huc=02070010&bBox=-83%2C36.5%2C-81%2C38.5&countyCd=51059&parameterCd=00060%2C00065&period=P7D&format=json&siteType=ST&modifiedSince=PT2H'
import requests

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

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

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

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 03:17:25.721724 400 685ms
2026-04-16 01:07:42.287837 400 608ms
2026-04-15 03:38:51.890139 400 721ms
2026-04-15 01:04:51.849707 400 734ms
2026-04-14 02:14:22.045460 400 605ms
2026-04-14 00:31:03.809646 400 742ms
2026-04-12 16:19:30.616122 400 1029ms
2026-04-12 15:36:58.004486 400 741ms
2026-04-10 02:56:58.442871 400 705ms
2026-04-10 02:28:31.910713 400 790ms
2026-04-09 01:25:34.100766 400 769ms
2026-04-09 00:03:47.818569 400 615ms
2026-03-23 10:27:02.024410 400 469ms