> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.iklim.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Lightning Notification

> Deep dive into iklim.co lightning strike webhook payloads for automation-ready apps.

<CardGroup cols={3}>
  <Card title="⚡ Instant situational awareness" icon="bolt-lightning">
    Every payload corresponds to a single lightning strike observed by our national detection grid.
  </Card>

  <Card title="🗺️ Pinpoint accuracy" icon="location-dot">
    Latitude/longitude pairs point to the geodesic centroid of the strike with meter-level precision.
  </Card>

  <Card title="🤝 Action-ready context" icon="handshake-simple">
    Use the enriched attributes (current, multiplicity, distance) to decide whether to trigger claims or operational workflows.
  </Card>
</CardGroup>

<Tabs>
  <Tab title="Sample payload 💾" icon="code">
    ```json theme={null}
    {
      "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
    }
    ```
  </Tab>

  <Tab title="Field glossary 📚" icon="table-list">
    | 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.     |
  </Tab>

  <Tab title="Multiplicity snapshot 🔢" icon="list-ol">
    | 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.                 |
  </Tab>
</Tabs>

<Steps>
  <Step title="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.
  </Step>

  <Step title="Score severity ⚙️">
    Combine `peakCurrent`, `distance`, and `multiplicity.*` to enrich your risk models (e.g., heavier current + short distance → immediate dispatch).
  </Step>

  <Step title="Log for post-event audits 📒">
    Store `lightningId` + coordinates so you can justify claim decisions or correlate against sensor data later.
  </Step>
</Steps>