Reports API Guide

Search reports

https://{{api} or {{apidev}}.accuweather.com/reports/{version}/localstorm.{format}?apikey={your key}{&minLatitude={minimum latitude}&maxLatitude={maximum latitude}&minLongitude={minimum longitude}&maxLongitude={maximum longitude}}&category={category}&startTime={start time}&endTime={end time}

Examples

https://api.accuweather.com/reports/v1/localstorm.json?apikey={your key}

[ { "id": 2898287, "dateTime": "2024-07-21T20:00:00+00:00", "event": "Funnel Cloud", "category": "TORNADO", "geometry": { "type": "point", "coordinates": [ -89.26, 40.62 ] }, "magnitude": null, "distanceFromCity": { "value": 1.0, "unit": "mi" }, "directionFromCity": "SE", "city": "Goodfield", "SupplementalAdminAreas": [ { "level": 2, "name": "Woodford", "type": "county" } ], "administrativeAreaId": "IL", "countryId": "US", "source": "NWS Employee", "fatalities": null, "injuries": null, "remarks": "" }, { "id": 2898285, "dateTime": "2024-07-21T20:05:00+00:00", "event": "Funnel Cloud", "category": "TORNADO", "geometry": { "type": "point", "coordinates": [ -89.41, 40.7 ] }, "magnitude": null, "distanceFromCity": null, "directionFromCity": "", "city": "Washington", "SupplementalAdminAreas": [ { "level": 2, "name": "Tazewell", "type": "county" } ], "administrativeAreaId": "IL", "countryId": "US", "source": "Public", "fatalities": null, "injuries": null, "remarks": "Relayed via social media. Funnel or cold air funnel." }, { "id": 2898282, "dateTime": "2024-07-21T20:05:00+00:00", "event": "Hail", "category": "HAIL", "geometry": { "type": "point", "coordinates": [ -108.73, 37.21 ] }, "magnitude": { "value": 0.25, "unit": "Inch", "determination": "MEASURED" }, "distanceFromCity": null, "directionFromCity": "", "city": "Towaoc", "SupplementalAdminAreas": [ { "level": 2, "name": "Montezuma", "type": "county" } ], "administrativeAreaId": "CO", "countryId": "US", "source": "Emergency Mngr", "fatalities": null, "injuries": null, "remarks": "" }, {... } ]

https://api.accuweather.com/reports/v1/localstorm.geojson?apikey={your key}
&minLatitude=0&maxLatitude=60&minLongitude=-150&maxLongitude=-50

{ "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "coordinates": [ -89.41, 40.7 ], "type": "Point" }, "properties": { "category": "TORNADO", "city": { "name": "Washington", "direction": "", "distance": { "value": 0.0, "unit": "mi" } }, "county": null, "dateTime": "2024-07-21T20:05:00+00:00", "fatalities": null, "id": 2898285, "injuries": 0, "magnitude": null, "remarks": "Relayed via social media. Funnel or cold air funnel.", "source": "Public", "adminCode": "IL", "type": "Funnel Cloud", "colorHex": "#FF0000" } }, { "type": "Feature", "geometry": { "coordinates": [ -108.73, 37.21 ], "type": "Point" }, "properties": { "category": "HAIL", "city": { "name": "Towaoc", "direction": "", "distance": { "value": 0.0, "unit": "mi" } }, "county": null, "dateTime": "2024-07-21T20:05:00+00:00", "fatalities": null, "id": 2898282, "injuries": 0, "magnitude": { "value": 0.25, "unit": "Inch", "determination": "M" }, "remarks": "", "source": "Emergency Mngr", "adminCode": "CO", "type": "Hail", "colorHex": "#10FFFF" } }, { "type": "Feature", "geometry": { "coordinates": [ -108.73, 37.21 ], "type": "Point" }, "properties": { "category": "HAIL", "city": { "name": "Towaoc", "direction": "", "distance": { "value": 0.0, "unit": "mi" } }, "county": null, "dateTime": "2024-07-21T20:08:00+00:00", "fatalities": null, "id": 2898283, "injuries": 0, "magnitude": { "value": 0.5, "unit": "Inch", "determination": "E" }, "remarks": "", "source": "Public", "adminCode": "CO", "type": "Hail", "colorHex": "#10FFFF" } }, {... } ] }

https://api.accuweather.com/reports/v1/localstorm?apikey={your key}
&minLatitude=0&maxLatitude=60&minLongitude=-150&maxLongitude=-50
&category=hail

[ { "id": 2898282, "dateTime": "2024-07-21T20:05:00+00:00", "event": "Hail", "category": "HAIL", "geometry": { "type": "point", "coordinates": [ -108.73, 37.21 ] }, "magnitude": { "value": 0.25, "unit": "Inch", "determination": "MEASURED" }, "distanceFromCity": null, "directionFromCity": "", "city": "Towaoc", "SupplementalAdminAreas": [ { "level": 2, "name": "Montezuma", "type": "county" } ], "administrativeAreaId": "CO", "countryId": "US", "source": "Emergency Mngr", "fatalities": null, "injuries": null, "remarks": "" }, { "id": 2898283, "dateTime": "2024-07-21T20:08:00+00:00", "event": "Hail", "category": "HAIL", "geometry": { "type": "point", "coordinates": [ -108.73, 37.21 ] }, "magnitude": { "value": 0.5, "unit": "Inch", "determination": "ESTIMATED" }, "distanceFromCity": null, "directionFromCity": "", "city": "Towaoc", "SupplementalAdminAreas": [ { "level": 2, "name": "Montezuma", "type": "county" } ], "administrativeAreaId": "CO", "countryId": "US", "source": "Public", "fatalities": null, "injuries": null, "remarks": "" }, { "id": 2898288, "dateTime": "2024-07-21T20:40:00+00:00", "event": "Hail", "category": "HAIL", "geometry": { "type": "point", "coordinates": [ -107.87, 37.3 ] }, "magnitude": { "value": 0.25, "unit": "Inch", "determination": "MEASURED" }, "distanceFromCity": { "value": 1.0, "unit": "mi" }, "directionFromCity": "NNW", "city": "Durango", "SupplementalAdminAreas": [ { "level": 2, "name": "La Plata", "type": "county" } ], "administrativeAreaId": "CO", "countryId": "US", "source": "Public", "fatalities": null, "injuries": null, "remarks": "Report via social media." }, {... } ]

https://api.accuweather.com/reports/v1/localstorm.json?apikey={your key}&startTime=2024-06-12T12:00:00-06:00&endTime=2024-06-13T12:00:00-06:00

[ { "id": 2878042, "dateTime": "2024-06-12T18:00:00+00:00", "event": "Tstm Wnd Dmg", "category": "WIND", "geometry": { "type": "point", "coordinates": [ -93.42, 43.56 ] }, "magnitude": null, "distanceFromCity": null, "directionFromCity": "", "city": "Twin Lakes", "SupplementalAdminAreas": [ { "level": 2, "name": "Freeborn", "type": "county" } ], "administrativeAreaId": "MN", "countryId": "US", "source": "Broadcast Media", "fatalities": null, "injuries": null, "remarks": "Photo of downed tree in Twin Lakes. Time was estimated." }, { "id": 2878023, "dateTime": "2024-06-12T18:03:00+00:00", "event": "Rain", "category": "FLOOD", "geometry": { "type": "point", "coordinates": [ -97.35, 43.72 ] }, "magnitude": { "value": 2.0, "unit": "Inch", "determination": "UNKNOWN" }, "distanceFromCity": { "value": 2.0, "unit": "mi" }, "directionFromCity": "E", "city": "Salem", "SupplementalAdminAreas": [ { "level": 2, "name": "McCook", "type": "county" } ], "administrativeAreaId": "SD", "countryId": "US", "source": "Trained Spotter", "fatalities": null, "injuries": null, "remarks": "Spotter reported pea sized hail and heavy rain. They had 2 inches in their guage at the time of the phone call at 1300." }, { "id": 2878026, "dateTime": "2024-06-12T18:10:00+00:00", "event": "Flash Flood", "category": "FLOOD", "geometry": { "type": "point", "coordinates": [ -80.15, 26.05 ] }, "magnitude": null, "distanceFromCity": { "value": 1.0, "unit": "mi" }, "directionFromCity": "SW", "city": "Dania Beach", "SupplementalAdminAreas": [ { "level": 2, "name": "Broward", "type": "county" } ], "administrativeAreaId": "FL", "countryId": "US", "source": "Broadcast Media", "fatalities": null, "injuries": null, "remarks": "Sterling Road between SW 2nd and SW 3rd Ave in Dania Beach - under water." }, {... } ]

Top of page

List event categories

https://{{api} or {{apidev}}.accuweather.com/reports/{version}/localstorm/categories?apikey={your key}

Example

https://api.accuweather.com/reports/v1/localstorm/categories?apikey={yourkey}

[ { "id": 1, "name": "flood" }, { "id": 2, "name": "hail" }, { "id": 3, "name": "miscellaneous" }, { "id": 4, "name": "tornado" }, { "id": 5, "name": "wind" }, { "id": 6, "name": "winter" } ]

Top of page

Category metadata

https://{{api} or {{apidev}}.accuweather.com/reports/{version}/localstorm/categories/{categoryId}?apikey={your key}

Example

https://api.accuweather.com/reports/v1/localstorm/categories/1?apikey={yourkey}

{ "name": "flood", "id": 1, "events": [ { "name": "COASTAL FLOOD", "colorHex": "#008000" }, { "name": "FLASH FLOOD", "colorHex": "#008000" }, { "name": "FLOOD", "colorHex": "#008000" }, { "name": "FLOODING", "colorHex": "#008000" }, { "name": "RAIN", "colorHex": "#008000" }, { "name": "ICE JAM FLOODING", "colorHex": "#008000" }, { "name": "LAKESHORE FLOOD", "colorHex": "#008000" }, { "name": "RAIN", "colorHex": "#008000" } ] }

Top of page

General Info

Locations

Current Conditions

Forecasts

Alerts

International Air Quality

River Gauge

Reports

Indices

Weather Alarms

Climo

Tropical

Tidal Forecast

Astronomy

Maps

Imagery

Translations

Deep Links

Historical

Reports API Guide

Search reports

Examples

List event categories

Example

Category metadata

Example