List battery events

List the events of a battery in a given time range

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Battery events are triggered when metric measurements deviate from expected values and cross defined thresholds. These events help monitor the health and performance of batteries in the system.

For example, if a battery is expected to have a voltage of V=13.42, and a reading shows an unexpectedly low or high voltage that crosses the set thresholds, the system will trigger either a warning or an alert, depending on how high the deviation is.

Low voltage on battery, crossing the Alert threshold

The events list provides a historical record of all events a battery has experienced over time.

List of events the battery went through

The following metrics can trigger alerts:

  • Core temperature: The average temperature of the battery poles
  • Pole diff temperature: The temperature difference between the poles
  • Resistance: The battery's electrical resistance
  • Voltage: The battery's voltage level
  • Charge: The battery's charge level
  • Online: The battery's connectivity status with Astra (whether it's sending heartbeats)
Query Params
string
required

ID of battery to return

string

Acts as a filter for the groupId of events.

date-time

Last date time of the history (format ISO 8601). Defaults to today.

int64

Offset from the paginated results. Defaults to 0.

int64

Last number of history entries. Defaults to 10.

string
enum

Grouping of the data for the limits and offsets. If group is used, "limit 2" will return all events from the first 2 groups. Defaults to "event"

Allowed:
Responses

400

Invalid data supplied

404

History not found

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json