GET /data/v1

noaa.gov:noaa-ocean-api

Summary: Retrieve climate and weather data
Operation ID: getData
Auth: none
Description

Access historical weather observations, marine data, and climate summaries from NOAA's archive. Supports various datasets including daily summaries, hourly observations, and marine surface data.

Parameters (11)

bbox (string, query, optional)

Bounding box as four comma-separated numbers (N,W,S,E). North/South range -90 to 90, East/West range -180 to 180. Default is global extent.

dataTypes (string, query, optional)

Comma-separated list of data type codes (e.g., TMAX, TMIN, PRCP, TMP, SEA_SURF_TEMP, WIND_SPEED)

dataset (string, query, required)

Dataset identifier (e.g., daily-summaries, global-hourly, global-marine)

Constraints: {'enum': ['daily-summaries', 'global-hourly', 'global-marine', 'global-summary-of-the-day', 'global-summary-of-the-month', 'global-summary-of-the-year', 'global-historical-climatology-network-hourly', 'normals-daily', 'normals-monthly', 'normals-annualseasonal']}

endDate (string, query, required)

End date in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss). Use Z for UTC or +/-HH:mm for timezone offset (encode + as %2B)

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

Output format

Constraints: {'enum': ['json', 'csv', 'ssv', 'pdf', 'netcdf']}

includeAttributes (boolean, query, optional, default: False)

Include measurement attributes

includeStationLocation (boolean, query, optional, default: False)

Include station location (lat/lon) in output

includeStationName (boolean, query, optional, default: False)

Include station name in output

startDate (string, query, required)

Start date in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss). Use Z for UTC or +/-HH:mm for timezone offset (encode + as %2B)

stations (string, query, optional)

Comma-separated list of station identifiers

units (string, query, optional)

Unit system for output values

Constraints: {'enum': ['metric', 'standard']}

Examples (1)

TitleTypeURLAction
Retrieve climate and weather data openapi-spec https://www.ncei.noaa.gov/access/services/data/v1?bbox=40,-70,30,-60

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:43:36.555520 400 1014ms