ev.energy Webhook Event Types

This is the list of event types that we currently send.
For guidance on how to listen to these events, take a look at Svix's guide to consuming webhooks.

Event Types

charging_sub_session

data

object

Optional

The charging sub session being created

15 Items

timestamp

string

(date-time)

Optional

The timestamp of the event described by this webhook

type

string

Optional

Example Charging Sub Session Created Webhook

JSON

{
  "data": {
    "cost": 0,
    "currency": "GBP",
    "end": null,
    "energy_delivered_watt_hours": 0,
    "evse": "https://api.ev.energy/v2/evses/evse01HN2NFV2BBCV0HWP5X7T1905Y",
    "id": "csub01HSX81AJCX2KNRKBYTAZPCZ5M",
    "location": {
      "name": "Home"
    },
    "mode": "smart",
    "percentage_added": 0,
    "start": "2019-08-24T14:15:22Z",
    "url": "https://api.ev.energy/v2/charging_sub_sessions/csub01HSX81AJCX2KNRKBYTAZPCZ5M",
    "vehicle": "https://api.ev.energy/v2/vehicles/vhcl01HN2NJ9NMRZBXT1H6FT9N7735"
  },
  "timestamp": "2022-11-03T20:26:10.344522Z",
  "type": "charging_sub_session.created"
}

data

object

Optional

The charging sub session being created

15 Items

timestamp

string

(date-time)

Optional

The timestamp of the event described by this webhook

type

string

Optional

Example Charging Sub Session Ended Webhook

JSON

{
  "data": {
    "cost": 634,
    "currency": "GBP",
    "end": "2019-08-24T14:15:22Z",
    "energy_delivered_watt_hours": 2300,
    "evse": "https://api.ev.energy/v2/evses/evse01HN2NFV2BBCV0HWP5X7T1905Y",
    "id": "csub01HSX81AJCX2KNRKBYTAZPCZ5M",
    "location": {
      "name": "Home"
    },
    "mode": "smart",
    "percentage_added": 30,
    "start": "2019-08-24T14:15:22Z",
    "url": "https://api.ev.energy/v2/charging_sub_sessions/csub01HSX81AJCX2KNRKBYTAZPCZ5M",
    "vehicle": "https://api.ev.energy/v2/vehicles/vhcl01HN2NJ9NMRZBXT1H6FT9N7735"
  },
  "timestamp": "2022-11-03T20:26:10.344522Z",
  "type": "charging_sub_session.ended"
}