Reference

Endpoints

Every endpoint lives under /api/v1. See the overview for auth, rate limits, and common query parameters.

#Alerts

Active and recent weather alerts from the NWS, normalized with polygons or affected zone arrays. Covers warnings, watches, advisories, and statements.

#List alerts

GET/api/v1/alerts

Returns a GeoJSON FeatureCollection. Accepts every common spatial & temporal filter.

Parameters

active

bool

Only return alerts that have not expired yet.

event

string

Filter by NWS event type — e.g. event=Tornado Warning.

severity

string

Minor | Moderate | Severe | Extreme

wfo

string

NWS office ID, e.g. OUN, DTX.

curl

curl "https://atmostorm.com/api/v1/alerts?state=OK&active=true&severity=Severe"

#Get a single alert

GET/api/v1/alerts/{alert_id}

Returns the full alert record including the description text and instruction.

curl

curl "https://atmostorm.com/api/v1/alerts/12345"

#SPC Outlooks

Storm Prediction Center convective outlooks for days 1 through 8 (categorical and probabilistic).

#List outlook polygons

GET/api/v1/outlooks

Parameters

day

int (1–8)

Convective outlook day. Defaults to all.

outlook_type

string

curl

curl "https://atmostorm.com/api/v1/outlooks?day=1&outlook_type=categorical"

#SPC Watches

#List active watches

GET/api/v1/watches

Tornado and severe thunderstorm watches with hazard parameters (max hail size, max wind, PDS flag).

curl

curl "https://atmostorm.com/api/v1/watches?active=true"

#Mesoscale Discussions

#List SPC mesoscale discussions

GET/api/v1/discussions

Short-fuse convective discussions issued by SPC. Each includes the discussion text and bounding polygon.

curl

curl "https://atmostorm.com/api/v1/discussions?active=true"

#Storm reports

#List storm reports

GET/api/v1/reports

Tornado, hail, wind, and flood reports aggregated from SPC. Every report has a point geometry and (where available) a magnitude.

Parameters

report_type

string

tornado | hail | wind | flood

min_magnitude

float

Minimum magnitude (hail inches, wind kt, tornado EF).

curl

curl "https://atmostorm.com/api/v1/reports?report_type=tornado&start=2026-04-18T00:00Z"

#Observations

#Surface observations

GET/api/v1/observations

Surface weather observations from ASOS/AWOS (METAR) and CWOP stations. Returns temperature, dewpoint, wind, pressure, precip, and more.

Parameters

station

string

Station ID (e.g., KOUN). Exact match.

network

string

asos | awos | cwop

curl

curl "https://atmostorm.com/api/v1/observations?point=35.22,-97.44&radius=50km&latest=true"

#Soundings

#List recent soundings

GET/api/v1/soundings

Upper-air soundings (RAOB), including derived parameters: CAPE, CIN, LI, PWAT, SRH, STP, SCP.

curl

curl "https://atmostorm.com/api/v1/soundings?bbox=-100,33,-95,38&latest=true"

#Latest sounding at a station

GET/api/v1/soundings/{station}/latest

Full vertical profile (pressure, height, T, Td, wind).

curl

curl "https://atmostorm.com/api/v1/soundings/OUN/latest"

#HRRR model

#HRRR point forecast

GET/api/v1/models/hrrr/point

Hourly forecast at a single point from the High-Resolution Rapid Refresh model. Returns multiple variables for the requested hours ahead of the latest run.

Parameters

latrequired

float

Latitude (decimal degrees).

lonrequired

float

Longitude (decimal degrees).

hours

int (1–18)

Hours ahead to return. Default: 18.

curl

curl "https://atmostorm.com/api/v1/models/hrrr/point?lat=35.22&lon=-97.44&hours=12"

#List available model runs

GET/api/v1/models/available

Metadata about which model data is currently cached on disk.

#Lightning

#Recent lightning flashes

GET/api/v1/lightning

Cloud-to-ground flash points from GOES-19 GLM, parsed directly from NOAA's public S3 bucket. Returns a GeoJSON FeatureCollection of point geometries with flash_time,age_seconds (relative to the request time), and optional energy_fj(femtojoules) + area_km2.

Parameters

minutes

int (1–180)

Window to return. Defaults to 15 minutes.

bbox

w,s,e,n

Bounding box filter.

state

string

US state abbreviation shortcut.

limit

int (1–20000)

Max features returned. Default: 5000.

curl

curl "https://atmostorm.com/api/v1/lightning?state=OK&minutes=10"

#River gauges

#List river gauge readings

GET/api/v1/gauges

USGS streamflow gauges with current stage, discharge, and (where available) NWS flood-stage thresholds.

curl

curl "https://atmostorm.com/api/v1/gauges?state=OK&latest=true"

#Radar tiles

MRMS composite radar, rendered as map tiles suitable for dropping into any MapLibre / Mapbox / Leaflet layer.

#Radar map tile

GET/api/v1/radar/tiles/{product}/{z}/{x}/{y}.png

Parameters

productrequired

string

reflectivity | velocity (see /radar/products).

zrequired

int

Web Mercator zoom (typically 3–10).

xrequired

int

Tile column (XYZ).

yrequired

int

Tile row (XYZ).

frame

ISO 8601

Specific frame timestamp. Defaults to the latest available.

url

https://atmostorm.com/api/v1/radar/tiles/reflectivity/6/14/25.png

#Available radar products

GET/api/v1/radar/products

#Available radar frames (timestamps)

GET/api/v1/radar/frames

Useful for building a loop / animation slider.

#Satellite tiles

GOES-16 ABI imagery, projected to Web Mercator tiles. Channel 2 (visible) and Channel 13 (clean IR) are available.

#Satellite map tile

GET/api/v1/satellite/tiles/{product}/{z}/{x}/{y}.png

Parameters

productrequired

string

ch02_visible | ch13_ir

frame

ISO 8601

Specific frame timestamp. Defaults to the latest.

#Available satellite products

GET/api/v1/satellite/products

#Available satellite frames

GET/api/v1/satellite/frames

#Location summary

#One-call location snapshot

GET/api/v1/locations/summary

Aggregates every relevant product at a point: active alerts, current obs, nearest sounding, HRRR forecast, recent storm reports, SPC outlooks, and a single "status" field summarizing severity. Great for building dashboards.

Parameters

latrequired

float

Latitude.

lonrequired

float

Longitude.

curl

curl "https://atmostorm.com/api/v1/locations/summary?lat=35.22&lon=-97.44"

#Geocoding

#Forward geocode

GET/api/v1/geocode/search

Parameters

qrequired

string

Free-form place name or address.

curl

curl "https://atmostorm.com/api/v1/geocode/search?q=Norman,+OK"

#Reverse geocode

GET/api/v1/geocode/reverse

Parameters

latrequired

float

Latitude.

lonrequired

float

Longitude.

curl

curl "https://atmostorm.com/api/v1/geocode/reverse?lat=35.22&lon=-97.44"

#Meta / health

#System health

GET/api/v1/meta/health

Per-source ingest status, with last-success timestamps and rolling success rates.

curl

curl "https://atmostorm.com/api/v1/meta/health"

#List data sources

GET/api/v1/meta/sources

Which feeds are implemented, their cadence, and their status.

← Back to overview Open Swagger UI →