---
title: "System state"
method: GET
path: "/state"
tags: ["state"]
---

# System state

`GET /state`

Returns the complete state of the system. This structure is used by the UI and also published via websocket and MQTT. It can be filtered by JQ to only return a subset of the data. Note: the response mirrors the internal UI state and carries no compatibility promise. Fields may change or disappear between releases.

## Query parameters

- `jq` string

## Response `200`

Success

- State — unresolved $ref

## Changes

> 37 revisions in range; 1 could not be searched.

- **2026-08-03** `c75ef6921f05` — 1 breaking, 2 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - api tag `state` added
  - api tag `general` removed
- **2026-07-24** `e84dc2eafd11` — 1 breaking, 3 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - api operation id `state` removed and replaced with `getState`
  - api tag `general` added
  - api tag `state` removed
- **2026-07-23** `5f032b4182a7` — 1 breaking, 3 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - api operation id `getState` removed and replaced with `state`
  - api tag `state` added
  - api tag `general` removed
- **2026-07-20** `32e824ccacfe` — 1 warning
  - removed the optional property `result` from the response with the `200` status

[Change history](https://skmtc.dev/evcc-io/apis/evcc/changes/state/get.md)

---

[API](https://skmtc.dev/evcc-io/apis/evcc.md) · [All operations](https://skmtc.dev/evcc-io/apis/evcc/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evcc-io/evcc/revisions/5152af83a070/schema)