Storm Reports

Storm Reports

URL Path
https://data.api.xweather.com/stormreports/
Data Coverage
US
Update Interval
15 minutes
Time Range
1950-01-03 to now

The storm reports data set provides access to all local storm reports (LSR) as transmitted by the National Weather Service (NWS). These reports are received from storm spotters, such as amateur radio operators, storm chasers, law enforcement, emergency management, or citizens about severe weather conditions in their area.

Requests

Every request to the endpoint must include one of the supported actions in the url.

https://data.api.xweather.com/stormreports/{action}?client_id={client_id}&client_secret={client_secret}&{params}

Supported Actions

The following actions are supported with the /stormreports endpoint:

ActionDescription
:idType: stringTypically used for passing a geographical location name or identifier such as city name, lat/long, or even US and Canadian postal codes. Learn more.
closestType: stringBased on a location search, the results will be returned in order from closest to farthest. Learn more.
withinType: stringUses a circle or polygon, define an area to search for results. Learn more.
searchType: stringA generalized action that is determined with the endpoints query parameters. Learn more.

Response

The following is an example of what each object in the response will consist of. Depending on your requested action, the response may contain multiple instances of this object within an array.

Properties

id (string)

The unique identifier for the storm report.

loc (object)

The location of the record.

loc.long (number)

The place or nearest place to the record.

loc.lat (number)

The latitude coordinate of the record.

report (object)

Object containing information about the storm report.

report.timestamp (number)

UNIX timestamp of the report.

report.dateTimeISO (string)

The date and time of the report in ISO-8601 format.

report.code (string)

The report code as assigned by the NWS.

report.type (string)

The type of report.

report.cat (string)

The category of the storm report:
- avalanche
- blizzard
- dust
- fire
- flood
- fog
- hail
- ice
- lightning
- marine
- rain
- snow
- tides
- tornado
- tropical
- wind
- other

report.name (string)

The brief description of the report, usually contains the location or relative distance from a city.

report.detail (object)

Object containing detailed information about the storm report.

report.detail.text (string)

The measurement provided in the report, such as precipitation total, wind speed or hail size.

report.detail.rainIN (string)

The total observed rainfall in inches. Only included for rain/flood related events.

report.detail.rainMM (string)

The total observed rainfall in millimeters. Only included for rain/flood related events.

report.detail.snowIN (string)

The total observed snowfall in inches. Only included for snow related events.

report.detail.snowCM (string)

The total observed snowfall in centimeters. Only included for snow related events.

report.detail.sleetIN (string)

The total observed sleet accumulation in inches. Only included for ice related events.

report.detail.sleetCM (string)

The total observed sleet accumulation in centimeters. Only included for ice related events.

report.detail.hailIN (string)

The total observed hail size in inches. Only included for hail related events.

report.detail.hailMM (string)

The total observed hail size in millimeters. Only included for hail related events.

report.detail.windSpeedKTS (string)

The observed wind speed in knots. Only included for wind related events.

report.detail.windSpeedKPH (string)

The observed wind speed in kilometers per hour. Only included for wind related events.

report.detail.windSpeedMPH (string)

The observed wind speed in miles per hour. Only included for wind related events.

report.detail.windSpeedMPS (string)

The observed wind speed in meters per second. Only included for wind related events.

report.reporter (string)

The general organization who made the report.

report.wfo (string)

Deprecated : The weather forecast office reporting the event. Empty String if not available

report.comments (string)

Additional details and comments describing the event.

report.datetime (string)

DEPRECATED: Use report.dateTimeISO instead.

place (object)

Object containing information about the place or nearest place to the record.

place.name (string)

The place or nearest place to the record.

place.state (string)

The state abbreviation in which the response is located. This may be null or an empty string depending on the country.

place.county (string)

The US country name in which the response is located. This may be null or an empty string if unavailable.

place.country (string)

The 2 letter ISO-3166 country abbreviation in which the response is located.

profile (object)

Object containing information about the location or event.

profile.tz (string)

Timezone name of the location, such as America/New_York.

[
  {
    "id": "657c7103d2d3c000252e23ca",
    "loc": {
      "long": -99.83,
      "lat": 39.37
    },
    "report": {
      "timestamp": 1702652940,
      "dateTimeISO": "2023-12-15T09:09:00-06:00",
      "code": "J",
      "type": "fog",
      "cat": "fog",
      "name": "1 mi E Hill City",
      "detail": {
        "text": "0.25"
      },
      "reporter": "asos",
      "wfo": "",
      "comments": "ASOS station KHLC Hill City.",
      "datetime": "2023-12-15T09:09:00-06:00"
    },
    "place": {
      "name": "hill city",
      "state": "ks",
      "county": "graham",
      "country": "us"
    },
    "profile": {
      "tz": "America/Chicago"
    }
  }
]