---
title: "Batteries"
method: GET
path: "/v1/assets/batteries"
tags: ["On-site assets"]
---

# Batteries

`GET /v1/assets/batteries`

Read-only battery state of charge and charge/discharge power. A battery is one storage system on a site, mapped to the same import MPAN as the solar it sits with if any. VoltView does not dispatch the battery.

## Query parameters

- `granularity` 'hour' | 'day' | 'month' | 'year'
- `from` string, date-time
- `to` string, date-time

## Response `200`

Batteries retrieved successfully

- BatterySystem[]
  - `id` string — Battery identifier
  - `siteId` string — Site the battery is mapped to
  - `importMpan` string — Import MPAN the battery can offset
  - `usableCapacityKwh` number — Usable capacity in kWh
  - `coupledSolarId` string — Linked solar system if present
  - `portal` string — OEM or installer monitoring portal
  - `stateOfChargePct` number — State of charge as a percentage
  - `energyRemainingKwh` number — Energy remaining in kWh
  - `chargePowerKw` number — Charge power in kW, positive into the battery
  - `dischargePowerKw` number — Discharge power in kW, positive out of the battery
  - `chargeEnergyKwh` number — Charge energy in the interval in kWh
  - `dischargeEnergyKwh` number — Discharge energy in the interval in kWh
  - `status` 'ONLINE' | 'CHARGING' | 'DISCHARGING' | 'IDLE' | 'FAULT' — Battery status from the portal

## Other responses

- `4XX` — Client error response

## Changes

- **2026-09-02** `58e3dc41902d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/voltview/apis/voltview-api/changes/v1/assets/batteries/get.md)

---

[API](https://skmtc.dev/voltview/apis/voltview-api.md) · [All operations](https://skmtc.dev/voltview/apis/voltview-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voltview/voltview-api/revisions/58e3dc41902d/schema)