Volteras 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.
alertDefinitionId
string
createdAt
string
(date-time)
currentSeverity
anyOf
definition
AlertDefinitionBase
5 Items
id
string
metadata
AlertMetadata
2 Items
muted
boolean
oemAlerts
anyOf
OptionaloemDeviceId
string
resolutions
array[]
status
AlertStatus
triggerDescription
anyOf
OptionaltriggerName
anyOf
Optionalvin
anyOf
OptionalExample 1
Example 2
Example 3
Example 1 of 3
JSON
{
"alertDefinitionId": "h9v1j-51p5d-pqv5p-b4q33-h283d",
"createdAt": "2024-01-15T10:30:00Z",
"currentSeverity": "MEDIUM",
"definition": {
"category": {
"code": "TIRE_PRESSURE",
"description": "Low tire pressure or abnormal tire conditions detected",
"id": "fds95-z9cnz-8e0nz-rrqe6-sp835",
"name": "Tire pressure"
},
"description": "A tire is losing pressure",
"id": "h51p5d-pqv5p-b4q33-h283d-h9v1j",
"message": "Tire pressure is below the recommended level",
"name": "Tire deflating"
},
"id": "h283d-h9v1j-51p5d-pqv5p-b4q33",
"metadata": {
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:35:00Z"
},
"muted": false,
"oemAlerts": [
{
"affectedComponent": "TIRES",
"mappedCode": "TIRE_DEFLATING_ALERT",
"mappedMessage": "Tire deflating alert",
"oemCode": "TIRE_DEFLATING_ALERT",
"oemMessage": null,
"oemMetadata": {
"daily_tires_deflation_rate": -1.1,
"daily_tires_deflation_rate_recent": -1.6,
"daily_tires_pump_up_count": 0,
"hourly_tires_deflation_rate": 0.4,
"hourly_tires_pump_up_count": 0,
"recent_tires_pump_up_count": 0
},
"recommendedAction": "SERVICE_REQUIRED",
"severity": null,
"status": "ACTIVE",
"type": "FAULT"
}
],
"oemDeviceId": "h51p5d-pqv5p-b4q33-h283d-h9v1j",
"resolutions": [
{
"definition": {
"description": "Check and adjust tire pressure",
"id": "hb4q33-h283d-h9v1j-51p5d-pqv5p",
"name": "Tire Pressure Check"
},
"id": "hpqv5p-b4q33-h283d-h9v1j-51p5d",
"status": "PENDING",
"steps": [
{
"definition": {
"description": "Check tire pressure",
"id": "h9v1j-51p5d-pqv5p-b4q33-h283d",
"order": 1
},
"id": "hh283d-h9v1j-51p5d-pqv5p-b4q33",
"status": "PENDING"
}
]
}
],
"status": "ACTIVE",
"triggerDescription": null,
"triggerName": "Trigger",
"vin": "WBYF2AW010FN82675"
}command
VehicleCommandEnum
Enum for available commands.
deviceId
string
deviceType
string
failedReason
anyOf
Optionalid
string
status
OEMDeviceCommandExecutionStatus
Enum for command execution status.
timestamp
string
(date-time)
Example 1
Example 2
Example 3
Example 4
Example 5
Example 1 of 5
JSON
{
"command": "START_CHARGING",
"deviceId": "h9v1j-51p5d-pqv5p-b4q33-h283d",
"deviceType": "VEHICLE",
"failedReason": null,
"id": "h283d-h9v1j-51p5d-pqv5p-b4q33",
"status": "EXECUTED",
"timestamp": "2024-01-15T10:30:00Z"
}deviceType
string
id
string
timestamp
string
(date-time)
Example DeviceConnectedPayload
JSON
{
"deviceType": "VEHICLE",
"id": "h283d-h9v1j-51p5d-pqv5p-b4q33",
"timestamp": "2024-01-15T10:30:00Z"
}deviceType
string
id
string
timestamp
string
(date-time)
vin
anyOf
OptionalExample DeviceDisconnectedPayload
JSON
{
"deviceType": "VEHICLE",
"id": "h283d-h9v1j-51p5d-pqv5p-b4q33",
"timestamp": "2024-01-15T10:30:00Z",
"vin": "WBYF2AW010FN82675"
}root
oneOf
OptionalExample 1
Example 2
Example 3
Example 4
Example 5
Example 6
Example 7
Example 8
Example 9
Example 10
Example 11
Example 12
Example 1 of 12
JSON
{
"metricType": "STATE_OF_CHARGE",
"stateOfCharge": {
"unit": "percent",
"value": 85.5
},
"timestamp": "2024-01-15T10:30:00Z",
"vehicle": {
"id": "h283d-h9v1j-51p5d-pqv5p-b4q33",
"vin": "WBYF2AW010FN82675"
}
}distanceTravelledKm
anyOf
OptionalenergyEndKwh
anyOf
OptionalenergyStartKwh
anyOf
OptionalenergyUsedKwh
anyOf
Optionalid
string
odometerEnd
anyOf
OptionalodometerStart
anyOf
OptionalsocEnd
anyOf
OptionalsocStart
anyOf
OptionalsocUsed
anyOf
OptionalstartLatitude
anyOf
OptionalstartLongitude
anyOf
OptionalstartTimestamp
string
(date-time)
stopLatitude
anyOf
OptionalstopLongitude
anyOf
OptionalstopTimestamp
anyOf
Optionaltimestamp
string
(date-time)
vehicleId
string
vin
string
Example 1
Example 2
Example 3
Example 4
Example 1 of 4
JSON
{
"distanceTravelledKm": 25.5,
"energyEndKwh": 59.8,
"energyStartKwh": 65,
"energyUsedKwh": 5.2,
"id": "h283d-h9v1j-51p5d-pqv5p-b4q33",
"odometerEnd": 45255.5,
"odometerStart": 45230,
"socEnd": 77,
"socStart": 85,
"socUsed": 8,
"startLatitude": 37.7749,
"startLongitude": -122.4194,
"startTimestamp": "2024-01-15T10:00:00Z",
"stopLatitude": 37.7849,
"stopLongitude": -122.4094,
"stopTimestamp": "2024-01-15T10:35:00Z",
"timestamp": "2024-01-15T10:35:00Z",
"vehicleId": "h9v1j-51p5d-pqv5p-b4q33-h283d",
"vin": "WBYF2AW010FN82675"
}domain
RateLimitDomain
key
RateLimitKey
maxRequests
integer
objectId
string
remainingRequests
integer
timestamp
string
(date-time)
windowSizeSeconds
integer
Example 1
Example 2
Example 1 of 2
JSON
{
"domain": "VEHICLE",
"key": "BMW_ENERGY_API_COMMANDS",
"maxRequests": 100,
"objectId": "h283d-h9v1j-51p5d-pqv5p-b4q33",
"remainingRequests": 10,
"timestamp": "2024-01-15T10:30:00Z",
"windowSizeSeconds": 3600
}deviceType
string
id
string
Example DeviceConnectedPayload
JSON
{
"deviceType": "VEHICLE",
"id": "uuid-of-vehicle"
}DeviceTelemetry
oneOf
OptionalExample DeviceTelemetry
JSON
{
"location": {
"unit": "degree",
"value": {
"latitude": 70.02323,
"longitude": 79.2323
}
},
"metricType": "LOCATION",
"timestamp": "2024-10-16T09:00:01Z",
"vehicle": {
"id": "uuid-of-vehicle",
"vin": "vehicle-vin"
}
}