---
title: "List United States Severe Weather Alerts records"
method: GET
path: "/v1/data/united-states-severe-weather-alerts"
tags: ["Weather Alerts"]
---

# List United States Severe Weather Alerts records

`GET /v1/data/united-states-severe-weather-alerts`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/united-states-severe-weather-alerts`
- Auth: none declared. Required headers: `X-API-Key`

List United States Severe Weather Alerts records with optional filters and pagination.

**Source:** Source: NOAA / National Weather Service, api.weather.gov. (Public Domain (U.S. Government work, 17 U.S.C. 105)).

**Fields returned:**
- `alert_id` (str) — Unique National Weather Service alert identifier
- `event` (str) — Alert type, e.g. Tornado Warning or Flood Watch
- `headline` (str) — One-line human readable headline for the alert
- `area_description` (str) — Counties, zones or regions covered by the alert
- `severity` (str) — Extreme, Severe, Moderate, Minor or Unknown
- `urgency` (str) — Immediate, Expected, Future, Past or Unknown
- `certainty` (str) — Observed, Likely, Possible, Unlikely or Unknown
- `status` (str) — Actual, Exercise, Test or Draft
- `message_type` (str) — Alert, Update or Cancel
- `sender_name` (str) — Issuing weather forecast office
- `effective_at` (date) — When the alert takes effect
- `expires_at` (date) — When the alert expires

**Example:** `GET /v1/data/united-states-severe-weather-alerts?limit=10&event=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `event` string, nullable: Alert type, e.g. Tornado Warning or Flood Watch
- `severity` string, nullable: Extreme, Severe, Moderate, Minor or Unknown
- `urgency` string, nullable: Immediate, Expected, Future, Past or Unknown
- `status` string, nullable: Actual, Exercise, Test or Draft
- `sender_name` string, nullable: Issuing weather forecast office

## Headers

- `X-API-Key` string, required

## Response `200`

A page of United States Severe Weather Alerts records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)