v1

latestSwagger 2.02026-07-132137180.4 KB

Historical Lightning

Returns lightning data by lat/lon from a given date.

get/history/lightning

Query parameters

latnumber double required

Latitude component of location.

lonnumber double required

Longitude component of location.

datestring required

Date to retrieve data for. (YYYY-MM-DD)

limitinteger

Limit result lightning. (Default 1500, Max 2500)

skipinteger

Number of results to skip in response. (Offset)

search_distance_kminteger

Radial search distance from point in KM. (Default 20 KM - Max 75 KM)

sort'distance' | 'time' string

Sort results by either most recent occurrence, or least distance from point. (Default distance)

output_type'json' | 'geojson' string

Data type of reponse JSON or GeoJSON. Default JSON.

tz'local' | 'utc' string

Assumed timezone option to use for date parameter. Default is local.

keystring string required

Your registered API key.

Response

Lightning data.

countinteger

Total count of lightning events.

datestring

Valid date of data in response (YYYY-MM-DD).

limitinteger

Count of results in response (determined by limit parameter).

latnumber

Latitude of point.

lonnumber

Longitude of point.

search_distance_kminteger

Distance searched for lightning (radially) in KM.

search_minsnumber nullable

Time backwards from current time searched for lightning.

skipinteger nullable

Number of results that were skipped in response (same as offset).

sortstring

Ascending sort key of data (time or distance).

timezonestring

Timezone of valid date.

Example response

{
  "count": 1000,
  "date": "2025-08-20",
  "limit": 100,
  "lat": 35.5,
  "lon": -78.5,
  "search_distance_km": 25,
  "skip": 500,
  "sort": "distance",
  "timezone": "UTC",
  "lightning": [
    {
      "lat": 36,
      "lon": -78.25,
      "bearing_cardinal": "WSW",
      "bearing_degrees": 258,
      "distance_km": 19.21,
      "distance_mi": 11.94,
      "id": 61326,
      "timestamp_utc": "2024-08-17T15:35:52",
      "timestamp_local": "2024-08-17T10:35:52",
      "past_mins": 20.5,
      "type": "flash",
      "source": "sat"
    }
  ]
}