Lightning Notification

⚡ Instant situational awareness

Every payload corresponds to a single lightning strike observed by our national detection grid.

🗺️ Pinpoint accuracy

Latitude/longitude pairs point to the geodesic centroid of the strike with meter-level precision.

🤝 Action-ready context

Use the enriched attributes (current, multiplicity, distance) to decide whether to trigger claims or operational workflows.

Sample payload 💾
Field glossary 📚
Multiplicity snapshot 🔢

{
  "lightningId": "692c7dab7ca5904f700df66c",
  "registrationId": "e71fedf8-a0a9-462e-a972-47dc8a5586df",
  "recipientId": "recipient-04c2b9c7ad01",
  "timeEpochMillis": 1764523421822,
  "type": "FLASH_CLOUD_TO_GROUND",
  "latitude": 41.0600156,
  "longitude": 28.9795,
  "peakCurrent": -7986,
  "inCloudHeight": null,
  "multiplicity": {
    "inCloud": 0,
    "cloudToGround": 1
  },
  "distance": 4994.386847196682
}

Field	Type	Description
`lightningId`	string	Stable strike identifier generated by our detection platform.
`registrationId`	string	Subscription/registration that produced the webhook delivery.
`recipientId`	string	Caller-supplied identifier that points back to your system’s asset/customer record (not required to be human readable—use hashed/anonymous IDs if needed for GDPR compliance); it must stay unique per geometry because we allow only one registration for the same area per `recipientId`, letting you locate the target without storing our `registrationId`.
`timeEpochMillis`	number	Millisecond UTC timestamp for when the strike occurred.
`type`	enum	Strike classification such as `FLASH_CLOUD_TO_GROUND` or `FLASH_IN_CLOUD`.
`latitude`	number	Decimal degree latitude of the strike centroid (WGS84).
`longitude`	number	Decimal degree longitude of the strike centroid (WGS84).
`peakCurrent`	number	Peak current in amperes (negative values represent negative polarity ground strokes).
`inCloudHeight`	number/null	Estimated altitude in meters for in-cloud events; `null` for pure cloud-to-ground flashes.
`multiplicity`	object	Nested counts describing how many sub-strokes occurred during the detection window.
`distance`	number	Approximate meters between the event and the registration centroid; `0` when the strike sits on the asset.

`LightningType` catalog

Value	Meaning
`FLASH_CLOUD_TO_GROUND`	Lightning channel that connects cloud charge directly to the ground; usually carries the strongest current and risk.
`PULSE_IN_CLOUD`	Electrical pulse that stays confined within or between clouds; useful for awareness but typically less damaging.

Field	Type	Description
`multiplicity.inCloud`	integer	Number of in-cloud sub-strokes contributing to the flash.
`multiplicity.cloudToGround`	integer	Number of cloud-to-ground return strokes.

Filter by type 🧠

FLASH_CLOUD_TO_GROUND flashes usually drive the riskiest impacts—route them into high-priority queues, while in-cloud flashes can stay informational.

Score severity ⚙️

Combine peakCurrent, distance, and multiplicity.* to enrich your risk models (e.g., heavier current + short distance → immediate dispatch).

Log for post-event audits 📒

Store lightningId + coordinates so you can justify claim decisions or correlate against sensor data later.

Before You Start

Webhook Alarms

MCP Server

Auth & User APIs

Accounts API

Lightning API

Thunderstorm API

Precipitation API

Forecast API

Point Alarm API

Region Alarm API

Forecast Alarm API

Enroute API

⚡ Instant situational awareness

🗺️ Pinpoint accuracy

🤝 Action-ready context

`LightningType` catalog

⚡ Instant situational awareness

🗺️ Pinpoint accuracy

🤝 Action-ready context

​LightningType catalog

`LightningType` catalog