API Explorer

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

Offices & Outreach

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

GET https://api.weather.gov/offices/{officeId}

Details about one of the 122 local Weather Forecast Offices: address, phone number, the counties it covers and its parent region. Every forecast in the country is written by one of these offices.

Anyone who wants to know who actually forecasts for their area — and how to reach them.

Worked example

https://api.weather.gov/offices/TOP

NWS Topeka, the office covering the example point.

Open on api.weather.gov

cURL

curl "https://api.weather.gov/offices/TOP" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"

GET https://api.weather.gov/offices/{officeId}/briefing

Briefing packages an office has prepared, typically slide decks aimed at emergency managers before a significant event.

Emergency managers and partners who receive these directly.

GET https://api.weather.gov/offices/{officeId}/briefing/download/{briefingId}

Download one specific briefing package file — usually a slide deck an office prepared for emergency managers ahead of an event.

Emergency managers.

GET https://api.weather.gov/offices/{officeId}/briefing/download/latest

Download the most recent briefing package from an office.

Emergency managers.

GET https://api.weather.gov/offices/{officeId}/headlines

Notices an office has posted to the top of its own web page — usually about significant upcoming weather.

Local news and anyone following one office closely.

Worked example

https://api.weather.gov/offices/TOP/headlines

Open on api.weather.gov

cURL

curl "https://api.weather.gov/offices/TOP/headlines" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"

GET https://api.weather.gov/offices/{officeId}/headlines/{headlineId}

One specific notice an office posted to its own web page, with the full text rather than just the summary line.

Anyone following a link from a headline listing.

GET https://api.weather.gov/offices/{officeId}/weatherstories

The “weather story” graphic — the single annotated image an office publishes to explain the main weather concern of the day in one picture.

Broadcasters, social media accounts, and anyone who wants the day’s story at a glance.

Worked example

https://api.weather.gov/offices/TOP/weatherstories

Open on api.weather.gov

cURL

curl "https://api.weather.gov/offices/TOP/weatherstories" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"

GET https://api.weather.gov/offices/{officeId}/weatherstories/download/{imageId}

The image file behind a weather story graphic, for embedding the office’s own annotated summary of the day.

Anyone displaying the graphic.