Every endpoint on api.weather.gov, grouped and explained for people who don’t already
speak NWS — what it returns, who wants it, and a worked example you can run.
Built from the live OpenAPI spec (version 3.11.0) on
2026-08-22. New here?
Start with how it thinks.
69 endpoints shown
Forecasts
The forecast itself, in two flavours: the fine-grained grid a forecast office actually edits, and the zone-level text forecast written for the public.
The raw forecast grid behind the readable forecast: dozens of separate variables — temperature, dewpoint, wind speed and direction, sky cover, probability of precipitation, snowfall amount, wave height and more — each as its own time series. Nothing here is written as prose; it is the underlying numbers.
Researchers, hobbyists building custom visualisations, and anyone who wants a variable the plain forecast does not mention.
The familiar day-by-day forecast — “Tonight: Partly cloudy, low around 54” — for one square of a forecast office’s grid. Each square is roughly 2.5 km across. This is generated from the same grid a human forecaster edits, so it is the closest thing to “the official forecast” in machine-readable form.
The single most-used endpoint on the API. Anyone showing a forecast on a website, dashboard or e-ink display.
2 parameters
Name
In
Required
Notes
Feature-Flags
header
no
Enable future and experimental features (see documentation for more info):
* forecast_temperature_qv: Represent temperature as QuantitativeValue
* forecast_wind_speed_qv: Represent wind speed as QuantitativeValue
array
units
query
no
Use US customary or SI (metric) units in textual output
The same forecast broken into hour-by-hour steps rather than day and night periods. Useful when timing matters — when exactly the rain arrives, or how cold it gets at 6am.
Anyone planning around timing: event organisers, cyclists, farmers, schedulers.
2 parameters
Name
In
Required
Notes
Feature-Flags
header
no
Enable future and experimental features (see documentation for more info):
* forecast_temperature_qv: Represent temperature as QuantitativeValue
* forecast_wind_speed_qv: Represent wind speed as QuantitativeValue
array
units
query
no
Use US customary or SI (metric) units in textual output
The zone forecast — the older, coarser style of forecast written for a whole named area rather than a grid square. Zones are how NWS talked about the weather before gridded forecasts, and they are still how many warnings and public statements are scoped.
Broadcasters and anyone who wants the forecast phrased the way it appears in a public statement.