---
title: "Get Battery Bank Power Status"
method: POST
path: "/v1/battery_banks/{battery_bank_id}/power_status"
tags: ["battery_banks"]
---

# Get Battery Bank Power Status

`POST /v1/battery_banks/{battery_bank_id}/power_status`

## Request

- Base URL: `https://api.shapemaker.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shapemaker.io/v1/battery_banks/{battery_bank_id}/power_status`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

This endpoint returns the status of the battery bank.  .
The power status estimated by simulating the battery bank over time after the Grid Outage.
To simulate different scenarios you can pass extra batteries that are not part of the battery bank.

## Path parameters

- `battery_bank_id` integer, required

## Request body

- integer[]

## Response `200`

Successful Response

- PowerStatusView
  - `backupTimeH` number, required
  - `requiredBackupTimeH` number, required
  - `remainingSoCPercent` number, required
  - `backupStatus` 'MEETS_BACKUP_TIME' | 'BELOW_BACKUP_REQUIREMENT', required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/shapemaker/apis/shapemaker-api.md) - [All operations](https://skmtc.dev/shapemaker/apis/shapemaker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shapemaker/apis/shapemaker-api/revisions/b8461cf1236c?raw)