---
title: "Returns the current battery settings of a system"
method: GET
path: "/api/v4/systems/config/{system_id}/battery_settings"
tags: ["System Configurations"]
---

# Returns the current battery settings of a system

`GET /api/v4/systems/config/{system_id}/battery_settings`

## Request

- Base URL: `https://api-qa2.enphaseenergy.com`
- URL: `https://api-qa2.enphaseenergy.com/api/v4/systems/config/{system_id}/battery_settings`
- Auth: none declared
- TypeScript: <https://skmtc.dev/enphase/apis/monitoring-api/docs/api/v4/systems/config/:system_id/battery_settings/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the current battery settings of a system

## Path parameters

- `system_id` string, required

## Response `200`

OK

- object
  - `system_id` integer
  - `battery_mode` string: Current battery mode of the system. Possible values are Savings Mode, Full Backup, and Self - Consumption
  - `reserve_soc` integer: Reserve soc for the current mode
  - `energy_independence` string: Energy independence after peak hours enabled/disabled . Enabled: Battery will discharge to save money during peak hours when electricity rates are high. Once that is done, energy independence is prioritized. This will increase the energy self-sufficiency until the reserve soc is hit. Battery will charge from solar in the morning to get ready for the next period Disabled: Battery will discharge only during peak hours when electricity rates are high. During other times, battery will be idle or will charge from solar in the morning to get ready for the next period
  - `charge_from_grid` string: Charge battery from grid enabled/disabled. Enabled: Battery may also charge from the grid when in full backup mode or when battery charge is below the reserve capacity in savings or self-consumption mode
  - `battery_shutdown_level` integer: Level at which battery shutdowns to conserve energy. Battery restarts by using the conserved energy when the utility grid restores power or solar panels start producing energy

## Other responses

- `401`: Authentication Error
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `501`: Not Implemented

---

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