MaverickWX
Data health

NWS Guide

Browse the API

Every endpoint on api.weather.gov — what it returns, who wants it, and a worked example.

Categories

All endpoints69 Start Here3Forecasts5Alerts & Warnings8Observations & Stations7Radar8Aviation9Text Products9Zones & Geography4Offices & Outreach8NOAA Weather Radio3Icons, Imagery & Extras5

Built from the live OpenAPI spec (version 3.11.0) on 2026-09-09. New here? Start with how it thinks.

Start Here

Almost every question that begins with a latitude and longitude starts at one of these. They translate a location into the identifiers the rest of the API speaks.

GET https://api.weather.gov/points/{latitude},{longitude}

Give it a latitude and longitude and it tells you everything the API needs to know about that spot: which of the 122 local forecast offices covers it, which square of that office’s forecast grid it falls in, which forecast zone and county it belongs to, and which radar watches it. Nearly every other endpoint wants one of those identifiers, so this is where the chain starts.

Anyone building an app that starts from “where the user is”. If you have coordinates and want a forecast, you call this first.

Worked example

Worked example

https://api.weather.gov/points/39.7456,-97.0892

A spot in Washington County, Kansas. The response points at grid TOP/32,81 — feed that into the gridpoint forecast endpoint next.

Open on api.weather.gov

cURL

curl "https://api.weather.gov/points/39.7456,-97.0892" \
  -H "User-Agent: (myweatherapp.example.com, [email protected])"
GET https://api.weather.gov/points/{latitude},{longitude}/radio

Which NOAA Weather Radio transmitters cover a given point, so you know what frequency to tune an emergency radio to.

Emergency managers and preparedness sites telling people which channel to program.

Worked example

Worked example

https://api.weather.gov/points/39.7456,-97.0892/radio
Open on api.weather.gov

cURL

curl "https://api.weather.gov/points/39.7456,-97.0892/radio" \
  -H "User-Agent: (myweatherapp.example.com, [email protected])"
GET https://api.weather.gov/points/{latitude},{longitude}/stations

The observation stations nearest a given latitude and longitude, closest first. Handy when you want “what is it doing right now near me” rather than a forecast.

App developers who need a current-conditions station for an arbitrary point.

Worked example

Worked example

https://api.weather.gov/points/39.7456,-97.0892/stations
Open on api.weather.gov

cURL

curl "https://api.weather.gov/points/39.7456,-97.0892/stations" \
  -H "User-Agent: (myweatherapp.example.com, [email protected])"

Browse by category

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.

5 endpoints

Alerts & Warnings

Watches, warnings and advisories. This is the life-safety feed — for real decisions use official channels, but this is where the data lives.

8 endpoints

Observations & Stations

What the weather is doing right now, as measured by thousands of ground stations — mostly at airports.

7 endpoints

Radar

Metadata about the NEXRAD radar network: where the radars are, whether they are healthy, and how their data is flowing.

8 endpoints

Aviation

Products written for pilots and dispatchers: airport forecasts, in-flight hazard advisories, and the centres that issue them.

9 endpoints

Text Products

The raw text bulletins NWS has issued for decades — forecast discussions, administrative messages, statements. Hundreds of product types, all searchable.

9 endpoints

Zones & Geography

The shapes NWS divides the country into: forecast zones, counties, fire weather zones and marine areas.

4 endpoints

Offices & Outreach

The 122 local Weather Forecast Offices, plus the briefings and graphics they publish.

8 endpoints

NOAA Weather Radio

The transmitter network that broadcasts weather around the clock on VHF — the one your emergency radio picks up.

3 endpoints

Icons, Imagery & Extras

Supporting pieces: weather icons, satellite thumbnails and the official NWS glossary.

5 endpoints

Show all 69 endpoints on one page