Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

NOAA Offices API

The Offices API from NOAA — 8 operation(s) for offices.

NOAA Offices API is one of 17 APIs that NOAA publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 9 JSON Schema definitions.

Tagged areas include Offices. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a GitHub repository, and 9 JSON Schemas.

This API exposes 8 operations across 8 paths, and defines 14 schemas. It is described by OpenAPI 3.0.3, at version v4.0.

Requests are made against the base URL https://api.weather.gov.

8 operations 8 paths 14 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
v4.0
Base URL
https://api.weather.gov
Terms of Service
Resource Areas
1

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

Offices 8
GET
/offices/{officeId}
Returns metadata about a NWS forecast office
office 1 param → 200default
GET
/offices/{officeId}/briefing
Returns active briefing for an NWS office
office_briefing 1 param → 200default
GET
/offices/{officeId}/briefing/download/latest
Returns the latest briefing for an office
office_briefing_download_latest 1 param → 302default
GET
/offices/{officeId}/briefing/download/{briefingId}
Returns a briefing for an office
office_briefing_download 2 params → 200default
GET
/offices/{officeId}/headlines/{headlineId}
Returns a specific news headline for a given NWS office
office_headline 2 params → 200default
GET
/offices/{officeId}/headlines
Returns a list of news headlines for a given NWS office
office_headlines 1 param → 200default
GET
/offices/{officeId}/weatherstories
Returns active weather stories for an NWS office
office_weatherstory 1 param → 200default
GET
/offices/{officeId}/weatherstories/download/{imageId}
Returns the image for a weather story
office_weatherstory_image 2 params → 200default

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are Office (16 properties), OfficeHeadline (11 properties), NWSConnectDocumentMetadata (8 properties), ProblemDetail (6 properties). Each schema is shown below with its type and property counts.

JsonLdContext
NWSOfficeId
NWSForecastOfficeId
string
Three-letter identifier for a NWS office.
OfficeHeadlineCollection
object
2 properties 2 required
NWSConnectDocumentMetadata
object
Metadata for an NWS Connect document.
8 properties
NWSRegionalHQId
string
Three-letter identifier for a NWS Regional HQ.
NWSNationalHQId
string
Three-letter identifier for NWS National HQ.
OfficeHeadline
object
11 properties
OfficeBriefing
Office
object
16 properties
ProblemDetail
object
Detail about an error. This document conforms to RFC 7807 (Problem Details for HTTP APIs).
6 properties 6 required
OfficeWeatherStory
9 required
BinaryFile
string
OfficeWeatherStoryCollection
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

noaa-offices-api-openapi.yml Raw ↑

Other APIs NOAA publishes across the network.

Climate Data Online (CDO) API
CO-OPS Tides and Currents API
NOAA Alerts API
NOAA Aviation API
NOAA Glossary API
NOAA Gridpoints API
NOAA Icons API
NOAA Navigational Data API
NOAA Points API
NOAA Products API
NOAA Radar API
NOAA Radio API