▣ STANDARD DATA · TRAVEL

Retrieve NOAA Weather Alerts API

What it does

NOAA Weather Alerts lets you fetch active weather alerts for a specified area using a two-character region code. Send an area query value and, optionally, a limit to control how many alerts are returned.

Use it when you need current hazard or warning data for a U.S. state or similar area code in a workflow, dashboard, or notification system. For example, you might poll for active alerts before showing a local weather panel, triggering internal safety messages, or routing location-specific updates to users.

The request is simple: area is required and must be exactly two characters, and limit defaults to 100 with a maximum of 500. The response is a JSON object whose shape is not further constrained in the schema, so you should treat it as a structured alerts payload and read the fields documented by the API response itself.

NOAA Weather Alerts is a practical fit for applications that need timely weather status by region without building a separate feed parser.

GET

NOAA active alerts by area

https://api.eu.apyhub.com/dosvak/noaa-active-alerts-by-area

QUICKSTART

GUIDE

Quickstart

Get active NOAA alerts for a two-letter area code like TX.

curl -X GET "https://api.eu.apyhub.com/dosvak/noaa-active-alerts-by-area?area=TX&limit=1" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

count is how many alerts came back, total is how many are active for the area — they differ whenever limit truncates the list.

{
  "area": "TX",
  "count": 1,
  "total": 8,
  "alerts": [
    {
      "id": "urn:oid:2.49.0.1.840.0.2d4509ca3ea52595a122e29064f9c7d40d83df64.001.1",
      "event": "Flood Advisory",
      "severity": "Minor",
      "urgency": "Expected",
      "area_desc": "Dona Ana, NM; El Paso, TX",
      "headline": "Flood Advisory issued September 23 at 1:34AM MDT until September 23 at 3:00AM MDT by NWS El Paso Tx/Santa Teresa NM",
      "effective": "2026-09-23T01:34:00-06:00",
      "expires": "2026-09-23T03:00:00-06:00",
      "sender_name": "NWS El Paso Tx/Santa Teresa NM"
    }
  ],
  "attribution": [
    {
      "source": "NOAA / National Weather Service",
      "dataset": "NWS weather alerts and point metadata",
      "license": "U.S. federal government data",
      "url": "https://www.weather.gov/documentation/services-web-api",
      "notice": "Contains NOAA/NWS data and metadata. This product is not endorsed by NOAA."
    }
  ]
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves currently active NOAA / National Weather Service alerts for a US state or marine area, newest first.

Query Parameter(s)

Attribute	Type	Mandatory	Description
area	String	Yes	Area code with exactly 2 characters.
limit	Integer	No	Maximum number of results to return. Default: 100. Minimum: 1. Maximum: 500.

Response

Returns a JSON object with the queried area, how many alerts came back versus how many are active, the alerts themselves, and the NOAA source attribution.

Attribute	Type	Description
area	String	The area code that was queried.
count	Integer	Number of alerts returned in `alerts`, after `limit` is applied.
total	Integer	Total alerts active for the area, before `limit` is applied.
alerts	Object Array	Active alerts. Empty when the area has none.
alerts[].id	String	NWS alert identifier (URN).
alerts[].event	String	Alert type, e.g. `Flood Advisory`, `Special Weather Statement`.
alerts[].severity	String	`Extreme`, `Severe`, `Moderate`, `Minor`, or `Unknown`.
alerts[].urgency	String	`Immediate`, `Expected`, `Future`, `Past`, or `Unknown`.
alerts[].area_desc	String	Affected zones. May span more than one state.
alerts[].headline	String	Full NWS headline, with issue and expiry times and the issuing office.
alerts[].effective	String	When the alert took effect. ISO 8601 with local UTC offset.
alerts[].expires	String	When the alert expires. ISO 8601 with local UTC offset.
alerts[].sender_name	String	NWS office that issued the alert.
attribution	Object Array	Source and licence notice for the data. Always present.
attribution[].source	String	Data provider.
attribution[].dataset	String	Dataset name.
attribution[].license	String	Licence terms.
attribution[].url	String	Link to the upstream API documentation.
attribution[].notice	String	Required disclaimer to surface alongside the data.

An area with no active alerts returns count: 0, total: 0, and an empty alerts array — not an error.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLRetrieve NOAA Weather Point Metadata APIDosvak LLC CALLUS County Climate Search APIDosvak LLC CALLUS Top Climate Risk Counties APIDosvak LLC CALLUS County Climate Profile APIDosvak LLC

From the blog

Reads that touch this API.

Getting Started with APIs: A Beginner’s Guide 2026Sep 17, 2026 How to Use cURL HEAD Requests: A Developer’s GuideSep 10, 2026 Timezones Dictionary API: Global Timezone Data and Best Alternatives for 2026Jul 9, 2026 What Is CORS and Why Is It Blocking My Request?Sep 9, 2026