Get Battery History

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/devices/ABC123/battery?limit=50"

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/devices/ABC123/battery?from=2025-12-01T00:00:00Z&to=2025-12-17T00:00:00Z"

[
  {
    "_id": "...",
    "hardware_id": "ABC123",
    "timestamp": "2025-12-17T10:30:00.000Z",
    "battery_voltage": 12.4
  }
]

GET

devices

{id}

battery

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/devices/ABC123/battery?limit=50"

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/devices/ABC123/battery?from=2025-12-01T00:00:00Z&to=2025-12-17T00:00:00Z"

[
  {
    "_id": "...",
    "hardware_id": "ABC123",
    "timestamp": "2025-12-17T10:30:00.000Z",
    "battery_voltage": 12.4
  }
]

Returns battery telemetry records for a device. The id path parameter accepts either short_id or hardware_id.

Path parameters

string

required

Device identifier — either short_id or hardware_id.

number

default:"100"

Max records to return. Ignored when from/to are provided.

string

ISO 8601 date string (start of range). Required together with to.

string

ISO 8601 date string (end of range). Required together with from.

Returns an array of battery telemetry records.

object[]

Show Battery record

string

required

Record identifier.

string

required

Hardware identifier.

string

required

ISO 8601 timestamp.

number

required

Battery voltage reading.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/devices/ABC123/battery?limit=50"

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/devices/ABC123/battery?from=2025-12-01T00:00:00Z&to=2025-12-17T00:00:00Z"

[
  {
    "_id": "...",
    "hardware_id": "ABC123",
    "timestamp": "2025-12-17T10:30:00.000Z",
    "battery_voltage": 12.4
  }
]