Hail Archive

URL Path

https://data.api.xweather.com/hail/archive/

Data Coverage

US, Canada, Japan, Europe, Australia

Update Interval

Hourly

Time Range

01-01-2024 (US) & 02-01-2025 (Other Regions)

Access Multiplier

12x

The Archive Hail Data API endpoint provides comprehensive historical information on hail events across various locations. This endpoint allows users to access detailed records of past hail occurrences, including data on hail size, duration, and intensity. Users can query the API by specifying a date range and geographical coordinates or location identifiers. The endpoint returns data in JSON format, offering insights into hail patterns, frequency, and severity over time. This historical hail data can be invaluable for researchers, insurance companies, and meteorologists studying long-term climate trends or assessing hail-related risks in specific areas

Requests

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

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

Supported Actions

The following actions are supported with the /hail/archive endpoint:

Action	Description
:id	Type: 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.

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

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.

periods (array)

The archive periods.

periods.#.timestamp (number)

The UNIX timestamp of the valid time of the archive period.

periods.#.dateTimeISO (string)

The ISO 8601 date/time of the archive period valid time.

periods.#.maxSizeIN (number)

Maximum size of hail for this period in inches.

periods.#.maxSizeCM (number)

Maximum size of hail for this period in centimeters.

periods.#.probSevere (number)

Probability of severity for this hail event.

profile (object)

Object containing information about the location or event.

profile.tz (string)

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

profile.elevM (number)

The elevation of the location in meters.

profile.elevFT (number)

The elevation of the location in feet.

[
  {
    "loc": {
      "long": -93.463,
      "lat": 44.925
    },
    "periods": [
      {
        "timestamp": 1740981600,
        "dateTimeISO": "2025-03-03T00:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1740985200,
        "dateTimeISO": "2025-03-03T01:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1740988800,
        "dateTimeISO": "2025-03-03T02:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1740992400,
        "dateTimeISO": "2025-03-03T03:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1740996000,
        "dateTimeISO": "2025-03-03T04:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1740999600,
        "dateTimeISO": "2025-03-03T05:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1741003200,
        "dateTimeISO": "2025-03-03T06:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1741006800,
        "dateTimeISO": "2025-03-03T07:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1741010400,
        "dateTimeISO": "2025-03-03T08:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1741014000,
        "dateTimeISO": "2025-03-03T09:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      },
      {
        "timestamp": 1741017600,
        "dateTimeISO": "2025-03-03T10:00:00-06:00",
        "maxSizeIN": 0,
        "maxSizeCM": 0,
        "probSevere": 0
      }
    ],
    "profile": {
      "tz": "America/Chicago",
      "elevM": 314,
      "elevFT": 1030
    }
  }
]

Endpoints