---
title: "Get state of charge of a battery in kWh"
method: GET
path: "/v2/deployments/{userkey}/battery/historical/soc"
tags: ["deployment"]
---

# Get state of charge of a battery in kWh

`GET /v2/deployments/{userkey}/battery/historical/soc`

## Request

- Base URL: `https://api.repositpower.com`
- URL: `https://api.repositpower.com/v2/deployments/{userkey}/battery/historical/soc`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/repositpower/apis/reposit-customer-api-openapi-3-0/docs/v2/deployments/:userkey/battery/historical/soc/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `userkey` string, required

## Query parameters

- `start` integer
- `end` integer
- `delta_t` integer

## Headers

- `Reposit-Auth` string

## Response `200`

Successful operation

- BatteryHistoricalSoC
  - `batteryCapacity` number
  - `batterySOC` array[]
    - number[]

---

[API](https://skmtc.dev/repositpower/apis/reposit-customer-api-openapi-3-0.md) - [All operations](https://skmtc.dev/repositpower/apis/reposit-customer-api-openapi-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/repositpower/apis/reposit-customer-api-openapi-3-0/revisions/8c625fc29409?raw)