New telemetry points

Receive telemetry events at your HTTPS endpoint.

WEBHOOK telemetry

Example

{
  "event_id": "evt_3f9a1c",
  "type": "telemetry",
  "created_at": "2026-11-12T18:12:45Z",
  "data": {
    "batteries": [
      {
        "battery_id": "bat_1",
        "points": [
          {
            "measured_at": "2026-11-12T18:10:14Z",
            "received_at": "2026-11-12T18:12:44Z",
            "stored_energy_wh": 7867,
            "battery_power_w": 3150,
            "grid_power_w": 1820
          }
        ]
      },
      {
        "battery_id": "bat_2",
        "points": [
          {
            "measured_at": "2026-11-12T18:09:58Z",
            "received_at": "2026-11-12T18:12:44Z",
            "stored_energy_wh": 4210,
            "battery_power_w": -1200,
            "grid_power_w": -1650
          }
        ]
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

OAuth 2.0 client credentials. Obtain a token from POST /token.

Body

application/json

event_id · string · required

Unique event identifier, for deduplication.

type · string · required

Allowed value: "telemetry"

created_at · string<date-time> · required

When Kapa created the event.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?Z$

Example:

"2026-11-12T18:00:00Z"

data · object · required

Show child attributes

Response

2XX

Event received. Any other response, or no response, causes a retry.