# evcc (self-hosted) Battery API

**Canonical:** https://apis.io/apis/evcc/evcc-battery-api/  
**Provider:** evcc (self-hosted) — https://apis.io/providers/evcc/  
**Base URL:** https://demo.evcc.io/api  
**Documentation:** https://docs.evcc.io/

evcc (self-hosted) Battery API is one of 11 APIs that [evcc (self-hosted)](https://apis.io/providers/evcc/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include battery. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The battery API from evcc (self-hosted) — 12 operation(s) for battery.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/batterydischargecontrol/{enable}` | Control battery-discharge |
| POST | `/batterygriddischarge/{enable}` | Control battery grid discharge |
| DELETE | `/batterygridchargelimit` | Remove battery grid charge limit |
| POST | `/batterygridchargelimit/{cost}` | Set battery grid charge limit |
| DELETE | `/batterygriddischargelimit` | Remove battery grid discharge limit |
| POST | `/batterygriddischargelimit/{cost}` | Set battery grid discharge limit |
| DELETE | `/batterymode` | Disable external battery control |
| POST | `/batterymode/{batteryMode}` | Set external battery mode |
| POST | `/buffersoc/{soc}` | Set battery buffer SoC |
| POST | `/bufferstartsoc/{soc}` | Set battery buffer start SoC |
| POST | `/prioritysoc/{soc}` | Set battery priority SoC |
| POST | `/residualpower/{power}` | Set grid residual power |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/evcc/openapi/evcc-battery-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/evcc/json-schema/evcc-state-schema.json
- **JSONSchema** — https://artifacts.apis.io/evcc/json-schema/evcc-grid-sessions-schema.json
- **JSONSchema** — https://artifacts.apis.io/evcc/json-schema/evcc-charging-sessions-schema.json
- **JSONSchema** — https://artifacts.apis.io/evcc/json-schema/evcc-repeating-plan-schema.json
- **JSONSchema** — https://artifacts.apis.io/evcc/json-schema/evcc-flow-schema.json
- **JSONSchema** — https://artifacts.apis.io/evcc/json-schema/evcc-onboarding-state-schema.json

## Other evcc (self-hosted) APIs (10)

- [evcc (self-hosted) Auth API](https://apis.io/apis/evcc/evcc-auth-api/)
- [evcc (self-hosted) Db API](https://apis.io/apis/evcc/evcc-db-api/)
- [evcc (self-hosted) Experimental API](https://apis.io/apis/evcc/evcc-experimental-api/)
- [evcc (self-hosted) General API](https://apis.io/apis/evcc/evcc-general-api/)
- [evcc (self-hosted) Loadpoints API](https://apis.io/apis/evcc/evcc-loadpoints-api/)
- [evcc (self-hosted) Sessions API](https://apis.io/apis/evcc/evcc-sessions-api/)
- [evcc (self-hosted) State API](https://apis.io/apis/evcc/evcc-state-api/)
- [evcc (self-hosted) System API](https://apis.io/apis/evcc/evcc-system-api/)
- [evcc (self-hosted) Tariffs API](https://apis.io/apis/evcc/evcc-tariffs-api/)
- [evcc (self-hosted) Vehicles API](https://apis.io/apis/evcc/evcc-vehicles-api/)

## Tags

battery

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/evcc/evcc-battery-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/evcc/.