From 542a01fa20dd66638f78be33e374a9105809116a Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Thu, 23 Jul 2026 12:03:21 +0200
Subject: [PATCH] API: generate /api/state documentation from UI types (#31530)

---
 .github/workflows/documentation.yml           |    2 +-
 .github/workflows/openapi-validate.yml        |    3 +-
 .gitignore                                    |    1 +
 .../components/ChargingPlans/ChargingPlan.vue |    4 +-
 .../ChargingPlans/ChargingPlanModal.vue       |    8 +-
 .../components/ChargingPlans/PlanStrategy.vue |    2 +-
 .../ChargingPlans/PlansRepeatingSettings.vue  |    2 +-
 .../ChargingPlans/PlansSettings.vue           |   16 +-
 .../js/components/ChargingPlans/Warnings.vue  |    3 +-
 assets/js/components/ChargingPlans/types.d.ts |   39 -
 assets/js/components/Forecast/Chart.vue       |    3 +-
 assets/js/components/Forecast/GridDetails.vue |    3 +-
 assets/js/components/Forecast/PriceChart.vue  |    3 +-
 assets/js/components/Forecast/SolarChart.vue  |    2 +-
 .../js/components/Forecast/SolarDetails.vue   |    2 +-
 assets/js/components/Forecast/ValueChart.vue  |    2 +-
 .../js/components/Forecast/ValueDetails.vue   |    2 +-
 assets/js/components/Forecast/echarts.ts      |    2 +-
 assets/js/components/Forecast/types.ts        |   27 -
 assets/js/components/Loadpoints/Loadpoint.vue |    2 +-
 .../js/components/Tariff/SmartCostLimit.vue   |    3 +-
 assets/js/components/Vehicles/Title.vue       |    2 +-
 assets/js/components/Vehicles/Vehicle.vue     |    2 +-
 assets/js/types/evcc.ts                       |  627 +-
 assets/js/utils/forecast.ts                   |    2 +-
 cmd/openapi/openapi.go                        |   28 -
 eslint.config.mts                             |    1 +
 go.mod                                        |    1 -
 package-lock.json                             |  412 +-
 package.json                                  |   10 +-
 scripts/state-schema/index.ts                 |   33 +
 scripts/state-schema/openapi.ts               |   40 +
 scripts/state-schema/schemas.ts               |  221 +
 scripts/state-schema/validate.ts              |  114 +
 server/mcp/openapi.json                       | 8445 +++++++++++------
 server/mcp/openapi.md                         |   44 +-
 server/openapi.go                             |    3 +-
 server/openapi.state.yaml                     | 1814 ++++
 server/openapi.yaml                           |  176 +-
 server/openapi_test.go                        |    1 +
 tests/state-api.spec.ts                       |   28 +
 tsconfig.json                                 |    2 +-
 42 files changed, 8786 insertions(+), 3351 deletions(-)
 delete mode 100644 assets/js/components/ChargingPlans/types.d.ts
 delete mode 100644 assets/js/components/Forecast/types.ts
 delete mode 100644 cmd/openapi/openapi.go
 create mode 100644 scripts/state-schema/index.ts
 create mode 100644 scripts/state-schema/openapi.ts
 create mode 100644 scripts/state-schema/schemas.ts
 create mode 100644 scripts/state-schema/validate.ts
 create mode 100644 server/openapi.state.yaml
 create mode 100644 tests/state-api.spec.ts

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 37d36e1a4..f5dc4598c 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -58,7 +58,7 @@ jobs:
       - name: Prepare OpenAPI spec
         run: |
           mkdir -p ./openapi-deploy
-          cp ./server/openapi.yaml ./openapi-deploy/openapi.yaml
+          npx --yes @redocly/cli@2 bundle ./server/openapi.yaml -o ./openapi-deploy/openapi.yaml
 
       - name: Deploy OpenAPI spec to docs repo
         uses: peaceiris/actions-gh-pages@84c30a85c19949d7eee79c4ff27748b70285e453 # v4
diff --git a/.github/workflows/openapi-validate.yml b/.github/workflows/openapi-validate.yml
index 6e0999ad6..3a6176d76 100644
--- a/.github/workflows/openapi-validate.yml
+++ b/.github/workflows/openapi-validate.yml
@@ -8,6 +8,7 @@ on:
   pull_request:
     paths:
       - "server/openapi.yaml"
+      - "server/openapi.state.yaml"
       - ".github/workflows/openapi-validate.yml"
 
 jobs:
@@ -22,4 +23,4 @@ jobs:
         with:
           go-version: stable
       - name: Validate OpenAPI spec
-        run: go run github.com/getkin/kin-openapi/cmd/validate@v0.133.0 -- server/openapi.yaml
+        run: go run github.com/getkin/kin-openapi/cmd/validate@v0.133.0 -ext -- server/openapi.yaml
diff --git a/.gitignore b/.gitignore
index 48573ca2a..dd0405372 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,6 +18,7 @@ testdata/**/*
 !assets/js/**/*.yaml
 !package*.json
 !evcc.dist.yaml
+!server/openapi.state.yaml
 !.coderabbit.yaml
 !tests/**/*.evcc.yaml
 !tests/**/*.tpl.yaml
diff --git a/assets/js/components/ChargingPlans/ChargingPlan.vue b/assets/js/components/ChargingPlans/ChargingPlan.vue
index ab3edd481..96eeda0bc 100644
--- a/assets/js/components/ChargingPlans/ChargingPlan.vue
+++ b/assets/js/components/ChargingPlans/ChargingPlan.vue
@@ -38,9 +38,7 @@ import formatter from "@/mixins/formatter";
 import minuteTicker from "@/mixins/minuteTicker";
 import { optionStep, fmtEnergy } from "@/utils/energyOptions.ts";
 import { defineComponent, type PropType } from "vue";
-import type { CURRENCY, Vehicle } from "@/types/evcc";
-import type { PlanStrategy } from "./types";
-import type { Forecast } from "@/types/evcc.ts";
+import type { CURRENCY, Forecast, PlanStrategy, Vehicle } from "@/types/evcc";
 
 export default defineComponent({
 	name: "ChargingPlan",
diff --git a/assets/js/components/ChargingPlans/ChargingPlanModal.vue b/assets/js/components/ChargingPlans/ChargingPlanModal.vue
index bc019dd27..9a4784ebe 100644
--- a/assets/js/components/ChargingPlans/ChargingPlanModal.vue
+++ b/assets/js/components/ChargingPlans/ChargingPlanModal.vue
@@ -47,13 +47,17 @@ import GenericModal from "../Helper/GenericModal.vue";
 import PlansSettings from "./PlansSettings.vue";
 import api from "@/api";
 import type {
+	CURRENCY,
+	Forecast,
 	PlanStrategy,
 	RepeatingPlan,
+	SMART_COST_TYPE,
 	StaticEnergyPlan,
 	StaticPlan,
 	StaticSocPlan,
-} from "./types";
-import type { CURRENCY, Forecast, SMART_COST_TYPE, UiLoadpoint, Vehicle } from "@/types/evcc";
+	UiLoadpoint,
+	Vehicle,
+} from "@/types/evcc";
 
 export default defineComponent({
 	name: "ChargingPlanModal",
diff --git a/assets/js/components/ChargingPlans/PlanStrategy.vue b/assets/js/components/ChargingPlans/PlanStrategy.vue
index a8014a76b..0e63f3f83 100644
--- a/assets/js/components/ChargingPlans/PlanStrategy.vue
+++ b/assets/js/components/ChargingPlans/PlanStrategy.vue
@@ -64,7 +64,7 @@
 <script lang="ts">
 import { defineComponent } from "vue";
 import formatter from "@/mixins/formatter";
-import type { PlanStrategy } from "./types";
+import type { PlanStrategy } from "@/types/evcc";
 
 export default defineComponent({
 	name: "ChargingPlanStrategy",
diff --git a/assets/js/components/ChargingPlans/PlansRepeatingSettings.vue b/assets/js/components/ChargingPlans/PlansRepeatingSettings.vue
index ba25e8562..9a79fb49c 100644
--- a/assets/js/components/ChargingPlans/PlansRepeatingSettings.vue
+++ b/assets/js/components/ChargingPlans/PlansRepeatingSettings.vue
@@ -32,7 +32,7 @@ import PlanRepeatingSettings from "./PlanRepeatingSettings.vue";
 import deepEqual from "@/utils/deepEqual";
 import formatter from "@/mixins/formatter";
 import { defineComponent, type PropType } from "vue";
-import type { RepeatingPlan } from "./types";
+import type { RepeatingPlan } from "@/types/evcc";
 
 const DEFAULT_WEEKDAYS = [1, 2, 3, 4, 5];
 const DEFAULT_TARGET_TIME = "07:00";
diff --git a/assets/js/components/ChargingPlans/PlansSettings.vue b/assets/js/components/ChargingPlans/PlansSettings.vue
index d3e746e28..74016900d 100644
--- a/assets/js/components/ChargingPlans/PlansSettings.vue
+++ b/assets/js/components/ChargingPlans/PlansSettings.vue
@@ -81,16 +81,18 @@ import api from "@/api";
 import deepEqual from "@/utils/deepEqual";
 import { debounceLeading } from "@/utils/debounceLeading";
 import { defineComponent, type PropType } from "vue";
-import type { Vehicle, CURRENCY, Forecast } from "@/types/evcc";
 import type {
-	StaticPlan,
-	RepeatingPlan,
-	PlanWrapper,
-	StaticSocPlan,
-	StaticEnergyPlan,
+	CURRENCY,
+	Forecast,
 	PlanResponse,
 	PlanStrategy,
-} from "./types";
+	PlanWrapper,
+	RepeatingPlan,
+	StaticEnergyPlan,
+	StaticPlan,
+	StaticSocPlan,
+	Vehicle,
+} from "@/types/evcc";
 
 export default defineComponent({
 	name: "ChargingPlansSettings",
diff --git a/assets/js/components/ChargingPlans/Warnings.vue b/assets/js/components/ChargingPlans/Warnings.vue
index ea0caa4b4..b8329b756 100644
--- a/assets/js/components/ChargingPlans/Warnings.vue
+++ b/assets/js/components/ChargingPlans/Warnings.vue
@@ -21,8 +21,7 @@
 <script lang="ts">
 import { defineComponent, type PropType } from "vue";
 import formatter from "@/mixins/formatter";
-import type { PlanWrapper } from "./types";
-import type { Tariff } from "@/types/evcc";
+import type { PlanWrapper, Tariff } from "@/types/evcc";
 
 export default defineComponent({
 	name: "ChargingPlanWarnings",
diff --git a/assets/js/components/ChargingPlans/types.d.ts b/assets/js/components/ChargingPlans/types.d.ts
deleted file mode 100644
index 91031a05c..000000000
--- a/assets/js/components/ChargingPlans/types.d.ts
+++ /dev/null
@@ -1,39 +0,0 @@
-import type { Rate } from "@/types/evcc";
-
-export interface RepeatingPlan {
-  weekdays: number[];
-  time: string;
-  tz: string; // timezone like "Europe/Berlin"
-  soc: number;
-  active: boolean;
-}
-
-export interface PlanWrapper {
-  planId: number;
-  planTime: Date;
-  duration: number;
-  plan: Rate[] | null;
-  power: number;
-}
-
-export interface PlanResponse {
-  status: number;
-  data: PlanWrapper;
-}
-
-export type StaticPlan = StaticSocPlan | StaticEnergyPlan;
-
-export interface StaticSocPlan {
-  soc: number;
-  time: Date;
-}
-
-export interface StaticEnergyPlan {
-  energy: number;
-  time: Date;
-}
-
-export interface PlanStrategy {
-  continuous: boolean;
-  precondition: number;
-}
diff --git a/assets/js/components/Forecast/Chart.vue b/assets/js/components/Forecast/Chart.vue
index 1ae1a806e..3238a85fb 100644
--- a/assets/js/components/Forecast/Chart.vue
+++ b/assets/js/components/Forecast/Chart.vue
@@ -42,9 +42,8 @@ import "chartjs-adapter-dayjs-4/dist/chartjs-adapter-dayjs-4.esm";
 import { registerChartComponents, commonOptions } from "../Sessions/chartConfig";
 import formatter, { POWER_UNIT } from "@/mixins/formatter";
 import colors, { lighterColor } from "@/colors";
-import type { CURRENCY } from "@/types/evcc";
+import type { CURRENCY, ForecastSlot, SolarDetails, TimeseriesEntry } from "@/types/evcc";
 import { ForecastType, highestSlotIndexByDay } from "@/utils/forecast";
-import type { ForecastSlot, SolarDetails, TimeseriesEntry } from "./types";
 
 registerChartComponents([
 	BarController,
diff --git a/assets/js/components/Forecast/GridDetails.vue b/assets/js/components/Forecast/GridDetails.vue
index 70d5cecb0..012febe7f 100644
--- a/assets/js/components/Forecast/GridDetails.vue
+++ b/assets/js/components/Forecast/GridDetails.vue
@@ -50,8 +50,7 @@
 <script lang="ts">
 import { defineComponent, type PropType } from "vue";
 import formatter from "@/mixins/formatter";
-import type { CURRENCY } from "@/types/evcc";
-import type { ForecastSlot } from "./types";
+import type { CURRENCY, ForecastSlot } from "@/types/evcc";
 import { isStaticTariff } from "@/utils/forecast";
 
 const MAX_HOURS = 96;
diff --git a/assets/js/components/Forecast/PriceChart.vue b/assets/js/components/Forecast/PriceChart.vue
index 804416f3e..d0749f8b8 100644
--- a/assets/js/components/Forecast/PriceChart.vue
+++ b/assets/js/components/Forecast/PriceChart.vue
@@ -23,8 +23,7 @@ import {
 import colors, { lighterColor } from "@/colors";
 import formatter from "@/mixins/formatter";
 import chartMixin from "./chartMixin";
-import type { CURRENCY } from "@/types/evcc";
-import type { ForecastSlot } from "./types";
+import type { CURRENCY, ForecastSlot } from "@/types/evcc";
 
 export default defineComponent({
 	name: "PriceChart",
diff --git a/assets/js/components/Forecast/SolarChart.vue b/assets/js/components/Forecast/SolarChart.vue
index b2c997e29..97476d9ec 100644
--- a/assets/js/components/Forecast/SolarChart.vue
+++ b/assets/js/components/Forecast/SolarChart.vue
@@ -19,7 +19,7 @@ import colors, { lighterColor } from "@/colors";
 import formatter, { POWER_UNIT } from "@/mixins/formatter";
 import chartMixin from "./chartMixin";
 import { highestSlotIndexByDay } from "@/utils/forecast";
-import type { SolarDetails, TimeseriesEntry } from "./types";
+import type { SolarDetails, TimeseriesEntry } from "@/types/evcc";
 
 export default defineComponent({
 	name: "SolarChart",
diff --git a/assets/js/components/Forecast/SolarDetails.vue b/assets/js/components/Forecast/SolarDetails.vue
index 32497c190..18414ba69 100644
--- a/assets/js/components/Forecast/SolarDetails.vue
+++ b/assets/js/components/Forecast/SolarDetails.vue
@@ -19,7 +19,7 @@
 <script lang="ts">
 import { defineComponent, type PropType } from "vue";
 import formatter, { POWER_UNIT } from "@/mixins/formatter";
-import type { SolarDetails } from "./types";
+import type { SolarDetails } from "@/types/evcc";
 
 export default defineComponent({
 	name: "SolarDetails",
diff --git a/assets/js/components/Forecast/ValueChart.vue b/assets/js/components/Forecast/ValueChart.vue
index cc076933b..c5c981b91 100644
--- a/assets/js/components/Forecast/ValueChart.vue
+++ b/assets/js/components/Forecast/ValueChart.vue
@@ -22,7 +22,7 @@ import {
 import colors from "@/colors";
 import formatter from "@/mixins/formatter";
 import chartMixin from "./chartMixin";
-import type { ForecastSlot } from "./types";
+import type { ForecastSlot } from "@/types/evcc";
 
 export type ValueChartType = "co2" | "temperature";
 
diff --git a/assets/js/components/Forecast/ValueDetails.vue b/assets/js/components/Forecast/ValueDetails.vue
index ef3d95fa7..d3bd3fed9 100644
--- a/assets/js/components/Forecast/ValueDetails.vue
+++ b/assets/js/components/Forecast/ValueDetails.vue
@@ -20,7 +20,7 @@
 <script lang="ts">
 import { defineComponent, type PropType } from "vue";
 import formatter from "@/mixins/formatter";
-import type { ForecastSlot } from "./types";
+import type { ForecastSlot } from "@/types/evcc";
 import type { ValueChartType } from "./ValueChart.vue";
 
 const MAX_HOURS = 96;
diff --git a/assets/js/components/Forecast/echarts.ts b/assets/js/components/Forecast/echarts.ts
index 6798c2f3c..8bcc3d636 100644
--- a/assets/js/components/Forecast/echarts.ts
+++ b/assets/js/components/Forecast/echarts.ts
@@ -1,7 +1,7 @@
 import * as echarts from "echarts/core";
 import colors from "@/colors";
 import escapeHtml from "@/utils/escapeHtml";
-import type { ForecastSlot } from "./types";
+import type { ForecastSlot } from "@/types/evcc";
 import { BarChart, LineChart } from "echarts/charts";
 import {
   GridComponent,
diff --git a/assets/js/components/Forecast/types.ts b/assets/js/components/Forecast/types.ts
deleted file mode 100644
index 993be2a19..000000000
--- a/assets/js/components/Forecast/types.ts
+++ /dev/null
@@ -1,27 +0,0 @@
-export function isForecastSlot(obj?: TimeseriesEntry | ForecastSlot): obj is ForecastSlot {
-  return (obj as ForecastSlot).start !== undefined;
-}
-
-export interface TimeseriesEntry {
-  val: number;
-  ts: string;
-}
-
-export interface ForecastSlot {
-  start: string;
-  end: string;
-  value: number;
-}
-
-export interface EnergyByDay {
-  energy: number;
-  complete: boolean;
-}
-
-export interface SolarDetails {
-  scale?: number;
-  today?: EnergyByDay;
-  tomorrow?: EnergyByDay;
-  dayAfterTomorrow?: EnergyByDay;
-  timeseries?: TimeseriesEntry[];
-}
diff --git a/assets/js/components/Loadpoints/Loadpoint.vue b/assets/js/components/Loadpoints/Loadpoint.vue
index 5635e5430..a84e70f6c 100644
--- a/assets/js/components/Loadpoints/Loadpoint.vue
+++ b/assets/js/components/Loadpoints/Loadpoint.vue
@@ -129,9 +129,9 @@ import type {
 	SMART_COST_TYPE,
 	BATTERY_MODE,
 	LoadpointUi,
+	PlanStrategy,
 	LoadpointSuggestion,
 } from "@/types/evcc";
-import type { PlanStrategy } from "@/components/ChargingPlans/types";
 
 export default defineComponent({
 	name: "Loadpoint",
diff --git a/assets/js/components/Tariff/SmartCostLimit.vue b/assets/js/components/Tariff/SmartCostLimit.vue
index 89383a28b..c8b908060 100644
--- a/assets/js/components/Tariff/SmartCostLimit.vue
+++ b/assets/js/components/Tariff/SmartCostLimit.vue
@@ -24,8 +24,7 @@ import { defineComponent, type PropType } from "vue";
 import api from "@/api";
 import { setLoadpointLastSmartCostLimit } from "@/uiLoadpoints";
 import settings from "@/settings";
-import { type CURRENCY, SMART_COST_TYPE } from "@/types/evcc";
-import { type ForecastSlot } from "../Forecast/types";
+import { type CURRENCY, type ForecastSlot, SMART_COST_TYPE } from "@/types/evcc";
 
 export default defineComponent({
 	name: "SmartCostLimit",
diff --git a/assets/js/components/Vehicles/Title.vue b/assets/js/components/Vehicles/Title.vue
index 869eac73d..969efc59f 100644
--- a/assets/js/components/Vehicles/Title.vue
+++ b/assets/js/components/Vehicles/Title.vue
@@ -105,7 +105,7 @@ export default defineComponent({
 		},
 		vehicleOptions(): SelectOption<string>[] {
 			return this.vehicles.map((v) => ({
-				name: v.name,
+				name: v.name ?? "",
 				value: v.title,
 			}));
 		},
diff --git a/assets/js/components/Vehicles/Vehicle.vue b/assets/js/components/Vehicles/Vehicle.vue
index f157d4dd6..704077d5c 100644
--- a/assets/js/components/Vehicles/Vehicle.vue
+++ b/assets/js/components/Vehicles/Vehicle.vue
@@ -99,9 +99,9 @@ import {
 	type VehicleStatus,
 	type Vehicle,
 	type LoadpointUi,
+	type PlanStrategy,
 	type LoadpointSuggestion,
 } from "@/types/evcc";
-import type { PlanStrategy } from "@/components/ChargingPlans/types";
 import BatteryBoostButton from "../Loadpoints/BatteryBoostButton.vue";
 import type ChargingPlanModal from "../ChargingPlans/ChargingPlanModal.vue";
 
diff --git a/assets/js/types/evcc.ts b/assets/js/types/evcc.ts
index ee7ad95b6..be8a98e05 100644
--- a/assets/js/types/evcc.ts
+++ b/assets/js/types/evcc.ts
@@ -1,6 +1,3 @@
-import type { StaticPlan, RepeatingPlan, PlanStrategy } from "../components/ChargingPlans/types";
-import type { ForecastSlot, SolarDetails } from "../components/Forecast/types";
-
 // react-native-webview
 interface WebView {
   postMessage: (message: string) => void;
@@ -21,167 +18,378 @@ declare global {
   }
 }
 
+/** Status of configured vehicle authentication providers, keyed by provider name. */
 export type AuthProviders = Record<string, { id: string; authenticated: boolean }>;
 
 export type DeviceColors = Record<string, string>;
+/** Color assigned to a device for consistent UI display. */
 export type DeviceColorEntry = { title: string; color: string };
 
+/** MQTT integration configuration. */
 export interface MqttConfig {
+  /** Broker address. */
   broker: string;
+  /** Root topic all values are published under. */
   topic: string;
+  /** Broker username. */
+  user?: string;
+  /** Broker password. Redacted. */
+  password?: string;
+  /** MQTT client id. */
+  clientID?: string;
+  /** Skip TLS certificate verification. */
+  insecure?: boolean;
+  /** CA certificate for TLS connections. */
+  caCert?: string;
+  /** Client certificate for TLS connections. */
+  clientCert?: string;
+  /** Client key for TLS connections. */
+  clientKey?: string;
 }
 
+/** InfluxDB integration configuration. */
 export interface InfluxConfig {
+  /** InfluxDB server URL. */
   url: string;
-  database: any;
-  org: any;
+  /** Database name (InfluxDB 1.x) or bucket (InfluxDB 2.x). */
+  database: string;
+  /** Organization (InfluxDB 2.x). */
+  org: string;
+  /** Access token (InfluxDB 2.x). Redacted. */
+  token?: string;
+  /** Username (InfluxDB 1.x). */
+  user?: string;
+  /** Password (InfluxDB 1.x). Redacted. */
+  password?: string;
+  /** Skip TLS certificate verification. */
+  insecure?: boolean;
 }
 
+/** Network configuration. */
+export interface Network {
+  /** URL schema, http or https. */
+  schema?: string;
+  /** Hostname. */
+  host: string;
+  /** HTTP port. */
+  port: number;
+  /** Externally reachable URL. */
+  externalUrl?: string;
+  /** URL in the local network. */
+  internalUrl?: string;
+}
+
+/** Home energy management system configuration. */
 export interface HemsConfig {
+  /** A home energy management system is configured. */
   configured: boolean;
 }
 
+/** Current external limits imposed by the home energy management system. */
 export interface HemsStatus {
+  /** Consumption is currently limited. */
   dimmed?: boolean;
-  curtailed?: number; // allowed feed-in percent (0..100 integer), <100 = curtailed
+  /** Allowed feed-in in %. Values below 100 mean production is curtailed. */
+  curtailed?: number;
+  /** Maximum allowed consumption power in W. */
   maxConsumptionPower?: number;
+  /** Maximum allowed production power in W. */
   maxProductionPower?: number;
 }
 
+/** SMA Home Manager configuration. */
 export interface ShmConfig {
+  /** SMA vendor id. */
   vendorId: string;
+  /** SMA device id. */
   deviceId: string;
+  /** SMA device serial. */
+  deviceSerial?: string;
 }
 
+/** A fatal startup error. */
 export interface FatalError {
+  /** Error message. */
   error: string;
+  /** Device class the error originates from, like meter or charger. */
   class?: string;
+  /** Name of the device that caused the error. */
   device?: string;
 }
 
 export type StatisticsPeriod = "30d" | "365d" | "thisYear" | "total";
 export type StatisticsIndicator = "none" | "solar" | "price" | "savings" | "co2" | "co2saved";
 
+/** Aggregated charging statistics for a time period. */
 export interface StatisticsData {
+  /** Average CO₂ emissions in g/kWh. */
   avgCo2: number;
+  /** Average energy price per kWh in the configured currency. */
   avgPrice: number;
+  /** Total charged energy in kWh. */
   chargedKWh: number;
+  /** Share of solar energy in %. */
   solarPercentage: number;
 }
 
+/** Charging statistics, keyed by time period. */
 export type Statistics = Record<StatisticsPeriod, StatisticsData>;
 
+/**
+ * Complete system state as returned by /api/state and pushed via websocket and MQTT.
+ * This structure mirrors the internal UI state and carries no compatibility promise.
+ * Fields may change or disappear between releases.
+ */
 export interface State {
+  /** @internal */
   offline: boolean;
+  /** Telemetry is enabled. */
   telemetry?: boolean;
+  /** Experimental UI features are enabled. */
   experimental?: boolean;
+  /** Initial setup is required. */
   setupRequired?: boolean;
+  /** Startup has completed. */
   startupCompleted?: boolean;
+  /** HTTP API is ready to accept requests. */
   apiReady?: boolean;
+  /** Charging locations. One entry per configured loadpoint. */
   loadpoints: Loadpoint[];
+  /** Price, CO₂ and solar production forecasts. */
   forecast: Forecast;
+  /** Configured currency for all monetary values. */
   currency?: CURRENCY;
+  /** Fatal startup errors. */
   fatal?: FatalError[];
+  /** Status of configured vehicle authentication providers, keyed by provider name. */
   authProviders?: AuthProviders;
+  /** @internal */
   evopt?: EvOpt;
+  /** Running evcc version. */
   version?: string;
+  /** Latest available evcc version. */
   availableVersion?: string;
+  /**
+   * Operating system and architecture.
+   * @example "linux/amd64"
+   */
   system?: string;
+  /**
+   * Server time zone abbreviation and UTC offset.
+   * @example "CEST +02:00"
+   */
   timezone?: string;
+  /** Aggregated home battery state. */
   battery?: Battery;
+  /** Current operation mode of the home battery. */
   batteryMode?: BATTERY_MODE;
+  /** Grid meter data. */
   grid?: Meter;
+  /** A grid meter is configured. */
+  gridConfigured?: boolean;
+  /** Solar generation meters. One entry per configured pv meter. */
   pv?: Meter[];
+  /** Total solar generation power in W. Sum of all pv meters. */
+  pvPower?: number;
+  /** Total solar generation energy in kWh. */
+  pvEnergy?: number;
+  /** Auxiliary consumption meters. Their power is treated as available for charging. */
   aux?: Meter[];
+  /** Total power of all auxiliary meters in W. */
+  auxPower?: number;
+  /** Additional meters for monitoring purposes. */
   ext?: Meter[];
+  /** Consumption meters of individual devices for monitoring purposes. */
   consumers?: Meter[];
-  tariffs?: ConfigStatus<unknown, unknown>;
+  /** Home consumption power in W. */
+  homePower?: number;
+  /** Configured grid operating point in W. Positive values maintain grid import. */
+  residualPower?: number;
+  /** Share of green energy in home consumption, between 0 and 1. */
+  greenShareHome?: number;
+  /** Share of green energy used for charging, between 0 and 1. */
+  greenShareLoadpoints?: number;
+  /** Configured tariffs. Structure depends on configuration. */
+  tariffs?: GenericConfigStatus;
+  /** Current grid energy price per kWh in the configured currency. */
   tariffGrid?: number;
+  /** Current feed-in rate per kWh in the configured currency. */
   tariffFeedIn?: number;
+  /** Current grid CO₂ emissions in g/kWh. */
   tariffCo2?: number;
+  /** Current cost of solar generation per kWh in the configured currency. */
   tariffSolar?: number;
+  /** Current energy price of home consumption per kWh, taking the green energy share into account. */
+  tariffPriceHome?: number;
+  /** Current energy price of charging per kWh, taking the green energy share into account. */
+  tariffPriceLoadpoints?: number;
+  /** Current CO₂ emissions of home consumption in g/kWh, taking the green energy share into account. */
+  tariffCo2Home?: number;
+  /** Current CO₂ emissions of charging in g/kWh, taking the green energy share into account. */
+  tariffCo2Loadpoints?: number;
   tariffTemperature?: number;
+  /** MQTT integration configuration. */
   mqtt?: MqttConfig;
+  /** InfluxDB integration configuration. */
   influx?: InfluxConfig;
-  hems?: ConfigStatus<HemsConfig, HemsStatus>;
+  /** Network configuration. */
+  network?: Network;
+  /** Home energy management system integration. */
+  hems?: Hems;
+  /** SMA Home Manager configuration. */
   shm?: ShmConfig;
-  sponsor?: ConfigStatus<unknown, SponsorStatus>;
-  eebus?: ConfigStatus<EebusConfig, EebusStatus>;
+  /** Sponsorship status. */
+  sponsor?: Sponsor;
+  /** EEBus integration configuration and status. */
+  eebus?: Eebus;
+  /** Remote access configuration and connection status. */
   remote?: Remote;
-  modbusproxy?: ModbusProxy[];
-  messaging?: ConfigStatus<unknown, unknown>;
-  messagingEvents?: MessagingEvents;
+  /** Modbus proxy configuration. */
+  modbusproxy?: ModbusProxy[] | null;
+  /** Messaging services configuration. Structure depends on configuration. */
+  messaging?: GenericConfigStatus;
+  /** Configured notification messages per event type. */
+  messagingEvents?: MessagingEvents | null;
+  /** Update interval of the control loop in seconds. */
   interval?: number;
+  /** Load management circuits, keyed by circuit name. */
   circuits?: Record<string, Circuit>;
+  /** Battery buffer SoC in %. Energy above this level may be used for charging in solar mode. */
   bufferSoc?: number;
+  /** Battery priority SoC in %. Home battery is charged first while below this level. */
   prioritySoc?: number;
+  /** Battery buffer start SoC in %. Solar charging starts automatically above this level. */
   bufferStartSoc?: number;
+  /** Home battery discharge is prevented during fast charging and planned charging. */
   batteryDischargeControl?: boolean;
   solarAdjusted?: boolean;
+  /** Price or emission limit for charging the home battery from grid. */
   batteryGridChargeLimit?: number | null;
+  /** Home battery is currently charged from grid. */
+  batteryGridChargeActive?: boolean;
+  /** A dynamic grid price or CO₂ forecast is configured. */
   smartCostAvailable?: boolean;
+  /** Type of the smart charging limit, price based or emission based. */
   smartCostType?: SMART_COST_TYPE;
-  historyUpdated?: string; // ISO timestamp, bumped each 15min metrics persist
+  /** A feed-in tariff with forecast is configured. */
+  smartFeedInPriorityAvailable?: boolean;
+  /**
+   * Time of the last energy history update.
+   * @format date-time
+   */
+  historyUpdated?: string;
+  /** Configured site title. */
   siteTitle?: string;
+  /** Colors assigned to devices for consistent UI display. */
   deviceColors?: DeviceColorEntry[];
+  /** Configured vehicles, keyed by vehicle name. */
   vehicles: Record<string, Vehicle>;
+  /** Charging statistics over different time periods. */
   statistics?: Statistics;
+  /** Authentication is disabled. */
   authDisabled?: boolean;
+  /** Path of the evcc configuration file. */
   config?: string;
+  /** Path of the evcc database. */
   database?: string;
+  /** OCPP server configuration and connected stations. */
   ocpp?: Ocpp;
-  ocppforwarder?: ConfigStatus<OcppForwarderRule[], OcppForwarderSession[]>;
+  /** OCPP forwarder rules and upstream connection status. */
+  ocppforwarder?: OcppForwarder;
+  /** Battery optimizer is enabled. */
   optimizer?: boolean;
+  /** Selected battery optimizer charging strategy. */
   optimizerChargingStrategy?: string;
+  /** Available battery optimizer charging strategies. */
   optimizerChargingStrategies?: string[];
+  /** Built-in MCP server is enabled. */
   mcp?: boolean;
+  /** Instance runs in demo mode. */
+  demoMode?: boolean;
 }
 
+/** Configuration and runtime status of an integration. */
 export interface ConfigStatus<C, S> {
+  /** Static configuration. */
   config?: C;
+  /** Runtime status. */
   status?: S;
+  /** Source of the configuration, evcc.yaml file or database. */
   yamlSource?: YamlSource;
 }
 
+/** Configuration and runtime status of an integration. Structure depends on configuration. */
+export interface GenericConfigStatus extends ConfigStatus<unknown, unknown> {}
+
+/** Home energy management system integration. */
+export interface Hems extends ConfigStatus<HemsConfig, HemsStatus> {}
+
 export type YamlSource = "file" | "db" | undefined;
 
+/** OCPP server configuration. */
 export interface OcppConfig {
+  /** Port the OCPP server listens on. */
   port: number;
 }
 
+/** A rule forwarding an OCPP station to an upstream backend. */
 export interface OcppForwarderRule {
+  /** Station id to forward. */
   stationId: string;
+  /** URL of the upstream OCPP backend. */
   upstreamUrl: string;
+  /** Password for upstream authentication. Redacted. */
   password?: string;
+  /** Station id used towards the upstream backend. */
   upstreamStationId?: string;
+  /** Username for upstream authentication. */
   username?: string;
+  /** Skip TLS certificate verification. */
   insecure?: boolean;
+  /** CA certificate for TLS connections. */
   caCert?: string;
+  /** Only forward read operations to the station. */
   readOnly?: boolean;
 }
 
+/** OCPP forwarder rules and upstream connection status. */
+export interface OcppForwarder extends ConfigStatus<OcppForwarderRule[], OcppForwarderSession[]> {}
+
+/** Connection status of an OCPP forwarder rule. */
 export interface OcppForwarderSession {
+  /** Charger id. */
   chargerId: string;
+  /** URL of the upstream OCPP backend. */
   upstreamUrl: string;
+  /** Connection to the upstream backend is established. */
   upstreamConnected: boolean;
+  /** Last connection error. */
   error?: string;
 }
 
+/** OCPP server status. */
 export interface OcppStatus {
+  /** Externally reachable URL of the OCPP server. */
   externalUrl?: string;
+  /** Connection status per configured station. */
   stations: OcppStationStatus[];
 }
 
+/** OCPP server configuration and status. */
 export interface Ocpp {
   config: OcppConfig;
   status: OcppStatus;
 }
 
+/** Connection status of an OCPP station. */
 export interface OcppStationStatus {
+  /** Station id. */
   id: string;
+  /** Connection status. */
   status: OCPP_STATION_STATUS;
 }
 
+/** Connection status of an OCPP station. */
 export enum OCPP_STATION_STATUS {
   UNKNOWN = "unknown",
   CONFIGURED = "configured",
@@ -195,13 +403,21 @@ export interface Config {
   [key: string]: number | string | undefined;
 }
 
+/** A load management circuit limiting power and current of its assigned loadpoints. */
 export interface Circuit {
+  /** Circuit title for UI display. */
   title?: string;
+  /** Circuit icon name for UI display. */
   icon?: string;
+  /** Name of the parent circuit. */
   parent?: string;
+  /** Current power in W. */
   power: number;
+  /** Current in A. */
   current?: number;
+  /** Maximum allowed power in W. */
   maxPower?: number;
+  /** Maximum allowed current in A. */
   maxCurrent?: number;
 }
 
@@ -281,11 +497,15 @@ export interface ConfigLoadpoint {
   ui: LoadpointUi;
 }
 
+/** Display-only UI settings of a loadpoint. */
 export interface LoadpointUi {
+  /** Lower bound of the temperature scale for heating devices, in degrees. */
   minTemp: number;
+  /** Upper bound of the temperature scale for heating devices, in degrees. */
   maxTemp: number;
 }
 
+/** Type of the smart charging limit. */
 export enum SMART_COST_TYPE {
   CO2 = "co2",
   PRICE_DYNAMIC = "pricedynamic",
@@ -302,90 +522,212 @@ export enum TIME_FORMAT {
   H24 = "24",
 }
 
+/** A charging location with a charger, an optional dedicated meter and an optional vehicle. */
 export interface Loadpoint {
+  /** Unique loadpoint identifier used in API routes and configuration. */
   name: string;
+  /** Battery boost is active. When enabled, home battery power is used for fast charging. */
   batteryBoost: boolean;
+  /** Charging current per phase in A. */
   chargeCurrents?: number[];
+  /** Duration of the current charging session in seconds. */
   chargeDuration: number;
+  /** Current charging power in W. */
   chargePower: number;
+  /** Estimated remaining charging time in seconds. */
   chargeRemainingDuration?: number;
+  /** Estimated remaining energy in kWh. */
   chargeRemainingEnergy?: number;
+  /** Total energy imported by the charge meter in kWh. */
   chargeTotalImport?: number;
+  /** Charging voltage per phase in V. */
   chargeVoltages?: number[];
+  /** Energy charged in the current charging session in kWh. */
   chargedEnergy: number;
+  /** The connected vehicle is not identified automatically by its status. */
+  chargerFeatureAutodetectDisabled: boolean;
+  /** Values are averaged. */
+  chargerFeatureAverage: boolean;
+  /** Values are cached. */
+  chargerFeatureCacheable: boolean;
+  /** The climater state of the connected vehicle is ignored for charge control. */
+  chargerFeatureClimaterDisabled: boolean;
+  /** Charger only supports full ampere steps for current control. */
+  chargerFeatureCoarseCurrent: boolean;
+  /** Charger is a heating device where disabled means normal operation. */
   chargerFeatureContinuous: boolean;
+  /** Charger is a heating device. SoC values represent temperature in degrees. */
   chargerFeatureHeating: boolean;
+  /** Charger is an always-connected device without vehicles and charging sessions, like a heat pump. */
   chargerFeatureIntegratedDevice: boolean;
+  /** The connected vehicle only provides data while charging. */
+  chargerFeatureOffline: boolean;
+  /** Vehicle API calls are retried on failure. */
+  chargerFeatureRetryable: boolean;
+  /** The connected vehicle pushes data updates instead of being polled. */
+  chargerFeatureStreaming: boolean;
+  /** Charger is a switchable device without current control, like a heat pump or switch socket. */
   chargerFeatureSwitchDevice: boolean;
+  /** No wake-up calls are sent to the connected vehicle. */
+  chargerFeatureWakeUpDisabled: boolean;
+  /** The connected vehicle may need a short welcome charge to start communicating. */
+  chargerFeatureWelcomeCharge: boolean;
+  /** Charger icon name for UI display. */
   chargerIcon: string | null;
+  /** Charger supports automatic switching between 1-phase and 3-phase charging. */
   chargerPhases1p3p: boolean;
+  /** Charger is physically connected with a single phase. */
   chargerSinglePhase: boolean;
-  chargerStatusReason: CHARGER_STATUS_REASON | null;
+  /** Reason why the charger is waiting, like a pending authorization or a required disconnect. */
+  chargerStatusReason?: CHARGER_STATUS_REASON | null;
+  /** A vehicle is connected and charging. */
   charging: boolean;
+  /** A vehicle is connected to the charger. */
   connected: boolean;
+  /** Duration since the vehicle was connected, in seconds. */
   connectedDuration: number;
+  /** Delay before charging stops in solar mode, in seconds. */
   disableDelay: number;
+  /** Grid draw power above which charging stops in solar mode, in W. */
   disableThreshold: number;
+  /** Currently applied SoC limit in %. */
   effectiveLimitSoc: number;
+  /** Currently applied maximum charging current in A. */
   effectiveMaxCurrent: number;
+  /** Currently applied minimum charging current in A. */
   effectiveMinCurrent: number;
+  /** Currently applied minimum SoC in %. */
   effectiveMinSoc: number;
+  /** Id of the currently applied charging plan. Zero if no plan is active. */
   effectivePlanId: number;
+  /** SoC goal in % of the currently applied charging plan. */
   effectivePlanSoc: number;
+  /**
+   * Target time of the currently applied charging plan.
+   * @format date-time
+   */
   effectivePlanTime: string | null;
+  /** Currently applied charging plan strategy. */
   effectivePlanStrategy: PlanStrategy;
+  /** Currently applied priority. */
   effectivePriority: number;
+  /** Delay before charging starts in solar mode, in seconds. */
   enableDelay: number;
+  /** Available surplus power above which charging starts in solar mode, in W. */
   enableThreshold: number;
+  /** Charger is currently allowed to charge. */
   enabled: boolean;
+  /** Session energy limit in kWh. Zero means no limit. */
   limitEnergy: number;
+  /** Session SoC limit in %. Zero means no limit. */
   limitSoc: number;
+  /** Maximum charging current in A. */
   maxCurrent: number;
+  /** Minimum charging current in A. */
   minCurrent: number;
+  /** Minimum SoC in %. Vehicle is fast-charged until this level is reached. */
   minSoc: number;
+  /** Vehicle SoC is below the configured minimum SoC. */
   minSocNotReached: boolean;
+  /** Charging behavior. */
   mode: CHARGE_MODE;
+  /** Current offered to the vehicle in A. */
   offeredCurrent: number;
+  /** Pending phase switching action in solar mode. */
   phaseAction: PHASE_ACTION;
+  /** Remaining time until the pending phase switching action executes, in seconds. */
   phaseRemaining: number;
+  /** Number of phases expected to be used for charging. */
   phasesActive: number;
+  /** Configured phase mode. 0 is automatic switching, 1 and 3 select a fixed phase count. */
   phasesConfigured: number;
+  /** Time slots of the current charging plan. */
+  plan: Rate[] | null;
+  /** The current time slot is an active charging slot of the plan. */
   planActive: boolean;
+  /** Energy goal of the charging plan in kWh. */
   planEnergy: number;
+  /** Duration in seconds the charging plan is projected to miss its target time. */
   planOverrun: number;
+  /** Charging plan strategy. */
   planStrategy: PlanStrategy;
+  /**
+   * Projected end of the charging plan. End of the last planned slot.
+   * @format date-time
+   */
   planProjectedEnd: string | null;
+  /**
+   * Projected start of the charging plan. Start of the earliest planned slot.
+   * @format date-time
+   */
   planProjectedStart: string | null;
+  /**
+   * Target time of the charging plan.
+   * @format date-time
+   */
   planTime: string | null;
+  /** Priority for surplus distribution. Higher number means higher priority. */
   priority: number;
+  /** Pending charge start or stop action in solar mode. */
   pvAction: PV_ACTION;
+  /** Remaining time until the pending charge start or stop action executes, in seconds. */
   pvRemaining: number;
   last24hEnergy?: number;
   last7dEnergy?: number;
+  /** Average CO₂ emissions of the current charging session in g/kWh. */
   sessionCo2PerKWh: number | null;
+  /** Energy charged in the current charging session in kWh. */
   sessionEnergy: number;
+  /** Total cost of the current charging session in the configured currency. */
   sessionPrice: number | null;
+  /** Average energy price of the current charging session per kWh in the configured currency. */
   sessionPricePerKWh: number | null;
+  /** Share of solar energy in the current charging session in %. */
   sessionSolarPercentage: number;
+  /** Fast charging with cheap or clean grid energy is currently active. */
   smartCostActive: boolean;
+  /** Price or emission limit for fast charging with grid energy. */
   smartCostLimit: number | null;
+  /**
+   * Start of the next fast charging period with cheap or clean grid energy.
+   * @format date-time
+   */
   smartCostNextStart: string | null;
+  /** Charging pause for prioritized feed-in is currently active. */
   smartFeedInPriorityActive: boolean;
+  /** Feed-in rate limit above which charging is paused. */
   smartFeedInPriorityLimit: number | null;
+  /**
+   * Start of the next charging pause for prioritized feed-in.
+   * @format date-time
+   */
   smartFeedInPriorityNextStart: string | null;
+  /** Charging suggestion from the battery optimizer. */
   suggestion?: LoadpointSuggestion | null;
+  /** Loadpoint title for UI display. */
   title: string;
   todayEnergy?: number;
+  /** Climater of the connected vehicle is active. */
   vehicleClimaterActive: boolean | null;
+  /** Automatic vehicle detection is running. */
   vehicleDetectionActive: boolean;
+  /** SoC limit configured in the vehicle itself, in %. */
   vehicleLimitSoc: number;
+  /** Unique name of the connected vehicle. Empty for guest vehicles. */
   vehicleName: string;
+  /** Odometer reading of the connected vehicle in km. */
   vehicleOdometer: number;
+  /** Range of the connected vehicle in km. */
   vehicleRange: number;
+  /** Charge level of the connected vehicle in %. Temperature in degrees for heating devices. */
   vehicleSoc: number;
+  /** Title of the connected vehicle for UI display. */
   vehicleTitle: string;
+  /** A short welcome charge is active to enable vehicle communication. */
   vehicleWelcomeActive: boolean;
+  /** SoC limit for battery boost in %. */
   batteryBoostLimit: number;
+  /** Display-only UI settings. */
   ui?: LoadpointUi;
 }
 
@@ -418,6 +760,7 @@ export enum THEME {
   DARK = "dark",
 }
 
+/** Currency in ISO 4217 format. */
 export enum CURRENCY {
   AUD = "AUD",
   BGN = "BGN",
@@ -451,6 +794,7 @@ export enum ICON_SIZE {
   XL = "xl",
 }
 
+/** Charging mode. */
 export enum CHARGE_MODE {
   OFF = "off",
   NOW = "now",
@@ -458,6 +802,7 @@ export enum CHARGE_MODE {
   PV = "pv",
 }
 
+/** Battery operation mode. */
 export enum BATTERY_MODE {
   UNKNOWN = "unknown",
   NORMAL = "normal",
@@ -473,18 +818,21 @@ export enum PHASES {
   THREE_PHASES = 3,
 }
 
+/** Pending phase switching action in solar mode. */
 export enum PHASE_ACTION {
   INACTIVE = "inactive",
   SCALE_1P = "scale1p",
   SCALE_3P = "scale3p",
 }
 
+/** Pending charge start or stop action in solar mode. */
 export enum PV_ACTION {
   INACTIVE = "inactive",
   ENABLE = "enable",
   DISABLE = "disable",
 }
 
+/** Reason why the charger is waiting. */
 export enum CHARGER_STATUS_REASON {
   UNKNOWN = "unknown",
   WAITING_FOR_AUTHORIZATION = "waitingforauthorization",
@@ -510,20 +858,30 @@ export type SessionInfoKey =
   | "last24hEnergy"
   | "last7dEnergy";
 
+/** Sponsorship status. */
 export interface SponsorStatus {
+  /** Name of the sponsor. */
   name?: string;
+  /**
+   * Expiry time of the sponsor token.
+   * @format date-time
+   */
   expiresAt?: string;
+  /** Sponsor token expires soon. */
   expiresSoon?: boolean;
+  /** Sponsor token. Redacted. */
   token?: string;
 }
 
-export type Sponsor = ConfigStatus<any, SponsorStatus>;
+/** Sponsorship status. */
+export interface Sponsor extends ConfigStatus<unknown, SponsorStatus> {}
 
 export type VehicleOption = {
   key?: string | null;
   name: string | null;
 };
 
+/** Serial baud rate. */
 export enum MODBUS_BAUDRATE {
   _1200 = 1200,
   _9600 = 9600,
@@ -539,12 +897,14 @@ export enum MODBUS_TYPE {
   TCPIP = "tcpip",
 }
 
+/** Serial communication parameters. */
 export enum MODBUS_COMSET {
   _8N1 = "8N1",
   _8E1 = "8E1",
   _8N2 = "8N2",
 }
 
+/** How the Modbus proxy handles write requests. */
 export enum MODBUS_PROXY_READONLY {
   FALSE = "false",
   TRUE = "true",
@@ -561,21 +921,32 @@ export enum MODBUS_PROTOCOL {
   RTU = "rtu",
 }
 
+/** A TLS certificate key pair. */
 export type Certificate = {
+  /** Public certificate in PEM format. */
   public: string;
+  /** Private key in PEM format. Redacted. */
   private: string;
 };
 
-export type Remote = ConfigStatus<RemoteConfig, RemoteStatus>;
+/** Remote access configuration and connection status. */
+export interface Remote extends ConfigStatus<RemoteConfig, RemoteStatus> {}
 
+/** Remote access configuration. */
 export type RemoteConfig = {
+  /** Remote access is enabled. */
   enabled: boolean;
 };
 
+/** Remote access connection status. */
 export type RemoteStatus = {
+  /** Connection to the remote access server is established. */
   connected: boolean;
+  /** Remote access URL. */
   url?: string;
+  /** Remote login attempts are currently blocked by the rate limiter. */
   loginBlocked: boolean;
+  /** Last remote activity per client, keyed by username. RFC3339 timestamps. */
   lastSeen?: Record<string, string>;
 };
 
@@ -589,18 +960,28 @@ export type RemoteClientCreated = RemoteClient & {
   password: string;
 };
 
-export type Eebus = ConfigStatus<EebusConfig, EebusStatus>;
+/** EEBus integration configuration and status. */
+export interface Eebus extends ConfigStatus<EebusConfig, EebusStatus> {}
 
+/** EEBus integration configuration. */
 export type EebusConfig = {
-  uri: string;
+  /** URI the EEBus service listens on. */
+  uri?: string;
+  /** Port the EEBus service listens on. */
   port: number;
+  /** SHIP id. */
   shipid: string;
+  /** Network interfaces the EEBus service uses. */
   interfaces?: string[];
+  /** TLS certificate. */
   certificate?: Certificate;
 };
 
+/** EEBus runtime status. */
 export type EebusStatus = {
+  /** SKI (subject key identifier) used for pairing. */
   ski: string;
+  /** QR code payload for pairing. */
   qr?: string;
 };
 
@@ -610,12 +991,17 @@ export type EebusPairing = {
   source: "paired" | "ski";
 };
 
+/** A Modbus proxy forwarding requests to a physical device. */
 export type ModbusProxy = {
+  /** Port the proxy listens on. */
   port: number;
+  /** How write requests are handled. */
   readonly: MODBUS_PROXY_READONLY;
+  /** Connection settings of the physical device. */
   settings: ModbusProxySettings;
 };
 
+/** Configured notification messages, keyed by event type. */
 export type MessagingEvents = Record<MESSAGING_EVENTS, MessagingEvent>;
 
 export enum MESSAGING_EVENTS {
@@ -630,17 +1016,27 @@ export enum MESSAGING_EVENTS {
   SUGGESTION = "suggestion",
 }
 
+/** A configured notification message. */
 export interface MessagingEvent {
+  /** Message title template. */
   title: string;
+  /** Message body template. */
   msg: string;
+  /** Notifications for this event are disabled. */
   disabled: boolean;
 }
 
+/** Connection settings of a Modbus device. */
 export interface ModbusProxySettings {
+  /** Device address for TCP connections. */
   uri?: string;
+  /** Use RTU protocol over TCP. */
   rtu?: boolean;
+  /** Serial device path. */
   device?: string;
+  /** Serial baud rate. */
   baudrate?: MODBUS_BAUDRATE;
+  /** Serial communication parameters. */
   comset?: MODBUS_COMSET;
 }
 
@@ -652,66 +1048,176 @@ export interface Notification {
   count: number;
 }
 
+/** Measurement data of a single meter. */
 export interface Meter {
+  /** Unique device name of the meter. */
   name?: string;
+  /** Current power in W. */
   power: number;
+  /** Meter title for UI display. */
   title?: string;
+  /** Meter icon name for UI display. */
   icon?: string;
+  /** Total energy in kWh. */
   energy?: number;
+  /** Total exported energy in kWh. */
   returnEnergy?: number;
+  /** Power per phase in W. */
+  powers?: number[];
+  /** Current per phase in A. */
+  currents?: number[];
 }
 
+/** Projected home battery charge levels based on the solar and price forecast. */
 export interface BatteryForecast {
+  /** Projected highest charge level. */
   highest?: BatteryForecastPoint;
+  /** Projected lowest charge level. */
   lowest?: BatteryForecastPoint;
 }
 
+/** A projected home battery charge level at a point in time. */
 export interface BatteryForecastPoint {
-  soc: number; // percent
-  time: string; // ISO 8601 datetime
-  limit?: boolean; // true when SMax (highest) or SMin (lowest) boundary reached
+  /** Projected charge level in %. */
+  soc: number;
+  /**
+   * Time of the projected charge level.
+   * @format date-time
+   */
+  time: string;
+  /** The projection hits the upper or lower battery limit. */
+  limit?: boolean;
 }
 
+/** Home battery state. Aggregated across all battery meters. */
 export interface Battery {
+  /** Current battery power in W. Positive means discharging, negative means charging. */
   power: number;
+  /** Total battery capacity in kWh. */
   capacity: number;
+  /** Charge level in %. Weighted by capacity across all batteries. */
   soc: number;
+  /** Total battery energy in kWh. */
+  energy?: number;
+  /** Measurement data per battery meter. */
   devices?: BatteryMeter[];
+  /** Projected charge levels based on the solar and price forecast. */
   forecast?: BatteryForecast;
 }
 
+/** Battery optimizer suggestion for a home battery. */
 export interface BatterySuggestion {
+  /** Suggested operation mode. */
   action: "normal" | "hold" | "charge" | "holdcharge";
-  charge?: number; // recommended charge power, W
-  discharge?: number; // recommended discharge power, W
-  actionable?: boolean; // suggestion differs from the current operating mode
+  /** Recommended charge power in W. */
+  charge?: number;
+  /** Recommended discharge power in W. */
+  discharge?: number;
+  /** Suggestion differs from the current operating mode. */
+  actionable?: boolean;
 }
 
+/** Battery optimizer suggestion for a loadpoint. */
 export interface LoadpointSuggestion {
+  /** Suggested charging action. */
   action: "charge" | "stop";
-  charge?: number; // recommended charge power, W
-  discharge?: number; // recommended discharge power, W
-  actionable?: boolean; // suggestion differs from the current operating mode
+  /** Recommended charge power in W. */
+  charge?: number;
+  /** Recommended discharge power in W. */
+  discharge?: number;
+  /** Suggestion differs from the current operating mode. */
+  actionable?: boolean;
 }
 
+/** Measurement data of a single home battery meter. */
 export interface BatteryMeter extends Meter {
+  /** Charge level in %. */
   soc: number;
+  /** Battery supports external control of its operation mode. */
   controllable: boolean;
-  capacity: number; // 0 when not specified
+  /** Battery capacity in kWh. Zero when not specified. */
+  capacity: number;
+  /** Battery optimizer suggestion. */
   suggestion?: BatterySuggestion;
 }
 
+/** A repeating charging plan. */
+export interface RepeatingPlan {
+  /** Weekdays the plan is active. 0 is Sunday, 6 is Saturday. */
+  weekdays: number[];
+  /** Target time in HH:MM format. */
+  time: string;
+  /** Time zone of the target time, like Europe/Berlin. */
+  tz: string;
+  /** SoC goal in %. */
+  soc: number;
+  /** Plan is active. */
+  active: boolean;
+}
+
+export interface PlanWrapper {
+  planId: number;
+  planTime: Date;
+  duration: number;
+  plan: Rate[] | null;
+  power: number;
+}
+
+export interface PlanResponse {
+  status: number;
+  data: PlanWrapper;
+}
+
+/** Charging plan with a fixed target time and a SoC or energy goal. */
+export type StaticPlan = StaticSocPlan | StaticEnergyPlan;
+
+/** Charging plan with a SoC goal. */
+export interface StaticSocPlan {
+  /** SoC goal in %. */
+  soc: number;
+  /** Target time. */
+  time: Date;
+}
+
+/** Charging plan with an energy goal. */
+export interface StaticEnergyPlan {
+  /** Energy goal in kWh. */
+  energy: number;
+  /** Target time. */
+  time: Date;
+}
+
+/** Charging plan strategy. */
+export interface PlanStrategy {
+  /** Force continuous charging without gaps. */
+  continuous: boolean;
+  /** Duration of uninterrupted charging directly before the target time, in seconds. */
+  precondition: number;
+}
+
+/** A configured vehicle. */
 export interface Vehicle {
-  name: string;
+  /** Unique vehicle name used in API routes and configuration. */
+  name?: string;
+  /** Charge mode applied when the vehicle connects. */
   mode?: CHARGE_MODE | "";
+  /** Minimum SoC in %. Vehicle is fast-charged until this level is reached. */
   minSoc?: number;
+  /** SoC limit in %. Charging stops when reached. */
   limitSoc?: number;
+  /** Charging plan with a fixed target time and SoC or energy goal. */
   plan?: StaticPlan;
+  /** Repeating charging plans. */
   repeatingPlans: RepeatingPlan[] | null;
+  /** Charging plan strategy. */
   planStrategy: PlanStrategy;
+  /** Vehicle title for UI display. */
   title: string;
+  /** Feature flags of the vehicle implementation. */
   features?: string[];
+  /** Usable battery capacity in kWh. */
   capacity?: number;
+  /** Vehicle icon name for UI display. */
   icon?: string;
 }
 
@@ -727,9 +1233,13 @@ export interface Tariff {
   lastUpdate: Date;
 }
 
+/** A time slot with an associated price or emission value. */
 export interface Rate {
+  /** Start of the time slot. */
   start: Date;
+  /** End of the time slot. */
   end: Date;
+  /** Price per kWh in the configured currency or emissions in g/kWh. */
   value: number;
 }
 
@@ -745,11 +1255,66 @@ export interface Slot {
   selectable?: boolean | null;
 }
 
+/** A forecast value at a point in time. */
+export interface TimeseriesEntry {
+  /** Forecast power in W. */
+  val: number;
+  /**
+   * Time of the forecast value.
+   * @format date-time
+   */
+  ts: string;
+}
+
+/** A forecast value for a time slot. */
+export interface ForecastSlot {
+  /**
+   * Start of the time slot.
+   * @format date-time
+   */
+  start: string;
+  /**
+   * End of the time slot.
+   * @format date-time
+   */
+  end: string;
+  /** Forecast value of the time slot. Unit depends on the forecast type. */
+  value: number;
+}
+
+/** Expected solar production energy of a day. */
+export interface EnergyByDay {
+  /** Expected production energy in kWh. */
+  energy: number;
+  /** Forecast data covers the whole day. */
+  complete: boolean;
+}
+
+/** Solar production forecast. */
+export interface SolarDetails {
+  /** Correction factor applied to the forecast based on past production. */
+  scale?: number;
+  /** Expected production today. */
+  today?: EnergyByDay;
+  /** Expected production tomorrow. */
+  tomorrow?: EnergyByDay;
+  /** Expected production the day after tomorrow. */
+  dayAfterTomorrow?: EnergyByDay;
+  /** Expected production power over time. */
+  timeseries?: TimeseriesEntry[];
+}
+
+/** Price, CO₂ and solar production forecasts. */
 export interface Forecast {
+  /** Grid price forecast. Price per kWh in the configured currency per time slot. */
   grid?: ForecastSlot[];
+  /** CO₂ emission forecast in g/kWh per time slot. */
   co2?: ForecastSlot[];
+  /** Solar production forecast. */
   solar?: SolarDetails;
+  /** Charging cost forecast used by the plan optimizer per time slot. */
   planner?: ForecastSlot[];
+  /** Feed-in rate forecast. Rate per kWh in the configured currency per time slot. */
   feedin?: ForecastSlot[];
   temperature?: ForecastSlot[];
 }
diff --git a/assets/js/utils/forecast.ts b/assets/js/utils/forecast.ts
index e18719493..a5c14d114 100644
--- a/assets/js/utils/forecast.ts
+++ b/assets/js/utils/forecast.ts
@@ -1,4 +1,4 @@
-import type { ForecastSlot, TimeseriesEntry, SolarDetails } from "../components/Forecast/types";
+import type { ForecastSlot, TimeseriesEntry, SolarDetails } from "@/types/evcc";
 import deepCopy from "./deepClone";
 
 export enum ForecastType {
diff --git a/cmd/openapi/openapi.go b/cmd/openapi/openapi.go
deleted file mode 100644
index 366d62ff8..000000000
--- a/cmd/openapi/openapi.go
+++ /dev/null
@@ -1,28 +0,0 @@
-package main
-
-import (
-	"encoding/json"
-	"log"
-	"os"
-
-	"github.com/getkin/kin-openapi/openapi3"
-)
-
-func main() {
-	doc, err := openapi3.NewLoader().LoadFromFile(os.Args[1])
-	if err != nil {
-		log.Fatal("failed to load OpenAPI spec:", err)
-	}
-
-	// omit servers
-	doc.Servers = nil
-
-	b, err := json.MarshalIndent(doc, "", "  ")
-	if err != nil {
-		log.Fatal(err)
-	}
-
-	if err := os.WriteFile(os.Args[2], b, 0o644); err != nil {
-		log.Fatal(err)
-	}
-}
diff --git a/eslint.config.mts b/eslint.config.mts
index c4d9d0c01..a8878d649 100644
--- a/eslint.config.mts
+++ b/eslint.config.mts
@@ -30,6 +30,7 @@ export default [
 				"no-param-reassign": "error",
 				"vue/block-lang": "off",
 				"@typescript-eslint/no-explicit-any": "off",
+				"@typescript-eslint/no-empty-object-type": ["error", { allowInterfaces: "with-single-extends" }],
 			},
 		}
 	).map((config) => ({
diff --git a/go.mod b/go.mod
index 84de61530..18de0de77 100644
--- a/go.mod
+++ b/go.mod
@@ -257,7 +257,6 @@ require (
 tool (
 	github.com/dmarkham/enumer
 	github.com/evcc-io/evcc/cmd/implement
-	github.com/evcc-io/evcc/cmd/openapi
 	github.com/evcc-io/openapi-mcp/cmd/openapi-mcp
 	github.com/gokrazy/tools/cmd/gok
 	go.uber.org/mock/mockgen
diff --git a/package-lock.json b/package-lock.json
index cf48355c2..20c5dc313 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -39,6 +39,7 @@
         "@eslint/js": "^9.39.4",
         "@jest/types": "^30.4.1",
         "@playwright/test": "^1.60.0",
+        "@redocly/openapi-core": "^2.38.0",
         "@storybook/vue3": "^10.4.4",
         "@storybook/vue3-vite": "^10.4.4",
         "@types/body-parser": "^1.19.6",
@@ -56,6 +57,8 @@
         "@vue/eslint-config-typescript": "^14.8.0",
         "@vue/test-utils": "^2.4.11",
         "@vue/tsconfig": "^0.9.1",
+        "ajv": "^8.20.0",
+        "ajv-formats": "^3.0.1",
         "body-parser": "^2.2.2",
         "cross-env": "^10.1.0",
         "eslint": "^9.39.4",
@@ -77,6 +80,7 @@
         "rollup-plugin-visualizer": "^7.0.1",
         "storybook": "^10.4.6",
         "terser": "^5.48.0",
+        "ts-json-schema-generator": "^2.9.0",
         "tsx": "^4.22.4",
         "typescript": "^5.9.3",
         "typescript-eslint-language-service": "^5.0.5",
@@ -86,7 +90,8 @@
         "vue-hot-reload-api": "^2.3.4",
         "vue-tsc": "^3.3.5",
         "wait-on": "^9.0.10",
-        "ws": "^8.21.0"
+        "ws": "^8.21.0",
+        "yaml": "^2.9.0"
       },
       "engines": {
         "node": ">=26.0.0",
@@ -2344,6 +2349,23 @@
         "url": "https://opencollective.com/eslint"
       }
     },
+    "node_modules/@eslint/eslintrc/node_modules/ajv": {
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
+      "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.1",
+        "fast-json-stable-stringify": "^2.0.0",
+        "json-schema-traverse": "^0.4.1",
+        "uri-js": "^4.2.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
     "node_modules/@eslint/eslintrc/node_modules/globals": {
       "version": "14.0.0",
       "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz",
@@ -2357,6 +2379,13 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/@eslint/eslintrc/node_modules/json-schema-traverse": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
+      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@eslint/js": {
       "version": "9.39.4",
       "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.4.tgz",
@@ -3595,6 +3624,88 @@
         "url": "https://opencollective.com/popperjs"
       }
     },
+    "node_modules/@redocly/ajv": {
+      "version": "8.18.3",
+      "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.3.tgz",
+      "integrity": "sha512-l42u0of3hY98sN2A+M4qTX1O/KrpgGH32Hu9kP2GtHyD5Dfqq86PKFLe5dwaD8DEnNmlOlll2BAmeEtf0DaySg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/@redocly/config": {
+      "version": "0.50.1",
+      "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.50.1.tgz",
+      "integrity": "sha512-TrdZUK50baxIjJB/y2ROOqfg35ex+GbkHPoJ40kXQXKMOjrfxfYQ9IliiaLqT5H/Y8qbajPrYQN2DLfvcMaHSw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "json-schema-to-ts": "2.7.2"
+      }
+    },
+    "node_modules/@redocly/openapi-core": {
+      "version": "2.38.0",
+      "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-2.38.0.tgz",
+      "integrity": "sha512-VvUCotkNqVpJwW0zSzxp012a6dgv7dmgeCRCNk3BZ6tpwglLG93Vq6s1Hz6bnCexYwRjWU8NBvS/JBmDewr79Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@redocly/ajv": "^8.18.1",
+        "@redocly/config": "^0.50.1",
+        "ajv": "npm:@redocly/ajv@8.18.1",
+        "ajv-formats": "^3.0.1",
+        "colorette": "^1.2.0",
+        "graphql": "^16.14.1",
+        "js-levenshtein": "^1.1.6",
+        "js-yaml": "^4.2.0",
+        "picomatch": "^4.0.4",
+        "pluralize": "^8.0.0",
+        "yaml-ast-parser": "0.0.43"
+      },
+      "engines": {
+        "node": ">=22.12.0 || >=20.19.0 <21.0.0",
+        "npm": ">=10"
+      }
+    },
+    "node_modules/@redocly/openapi-core/node_modules/ajv": {
+      "name": "@redocly/ajv",
+      "version": "8.18.1",
+      "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.1.tgz",
+      "integrity": "sha512-Ifm/pP/tul1qmAecpbVxCBluVE32rKfjf8gYXH4xI2gCv9mRWFhJMHzkPDM4TXlxwPQYIFegymlsy8lXz7optA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/@redocly/openapi-core/node_modules/picomatch": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.5.tgz",
+      "integrity": "sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
     "node_modules/@reteps/dockerfmt": {
       "version": "0.5.4",
       "resolved": "https://registry.npmjs.org/@reteps/dockerfmt/-/dockerfmt-0.5.4.tgz",
@@ -5364,22 +5475,40 @@
       }
     },
     "node_modules/ajv": {
-      "version": "6.15.0",
-      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
-      "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==",
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "fast-deep-equal": "^3.1.1",
-        "fast-json-stable-stringify": "^2.0.0",
-        "json-schema-traverse": "^0.4.1",
-        "uri-js": "^4.2.2"
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
       },
       "funding": {
         "type": "github",
         "url": "https://github.com/sponsors/epoberezkin"
       }
     },
+    "node_modules/ajv-formats": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz",
+      "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "ajv": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/alien-signals": {
       "version": "1.0.13",
       "resolved": "https://registry.npmjs.org/alien-signals/-/alien-signals-1.0.13.tgz",
@@ -6298,6 +6427,13 @@
       "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
       "license": "MIT"
     },
+    "node_modules/colorette": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/colorette/-/colorette-1.4.0.tgz",
+      "integrity": "sha512-Y2oEozpomLn7Q3HFP7dpww7AtMJplbM9lGZP6RDfHqmbeRjiwRg4n6VM6j4KLmRke85uWEI7JqF17f3pqdRA0g==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/combined-stream": {
       "version": "1.0.8",
       "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
@@ -7561,6 +7697,23 @@
         "url": "https://opencollective.com/eslint"
       }
     },
+    "node_modules/eslint/node_modules/ajv": {
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
+      "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.1",
+        "fast-json-stable-stringify": "^2.0.0",
+        "json-schema-traverse": "^0.4.1",
+        "uri-js": "^4.2.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
     "node_modules/eslint/node_modules/eslint-visitor-keys": {
       "version": "4.2.1",
       "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz",
@@ -7574,6 +7727,13 @@
         "url": "https://opencollective.com/eslint"
       }
     },
+    "node_modules/eslint/node_modules/json-schema-traverse": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
+      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/esm-resolve": {
       "version": "1.0.11",
       "resolved": "https://registry.npmjs.org/esm-resolve/-/esm-resolve-1.0.11.tgz",
@@ -7793,6 +7953,23 @@
       "dev": true,
       "license": "0BSD"
     },
+    "node_modules/fast-uri": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.3.tgz",
+      "integrity": "sha512-i70LwGWUduXqzicKXWshooq+sWL1K3WUU5rKZNG/0i3a1OSoX3HqhH5WbWwTmqWfor4urUakGPiRQcleRZTwOg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/fastq": {
       "version": "1.20.1",
       "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz",
@@ -8201,6 +8378,16 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/graphql": {
+      "version": "16.14.2",
+      "resolved": "https://registry.npmjs.org/graphql/-/graphql-16.14.2.tgz",
+      "integrity": "sha512-Chq1s4CY7jmh8gO2qvLIJyfCDIN+EHLFW/9iShnp1z8FjBQMoodWP1kDC36VAMXXIvAjj4ARa7ntfAV2BrjsbA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^12.22.0 || ^14.16.0 || ^16.0.0 || >=17.0.0"
+      }
+    },
     "node_modules/happy-dom": {
       "version": "20.10.6",
       "resolved": "https://registry.npmjs.org/happy-dom/-/happy-dom-20.10.6.tgz",
@@ -9111,6 +9298,16 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/js-levenshtein": {
+      "version": "1.1.6",
+      "resolved": "https://registry.npmjs.org/js-levenshtein/-/js-levenshtein-1.1.6.tgz",
+      "integrity": "sha512-X2BB11YZtrRqY4EnQcLX5Rh373zbK4alC1FW7D7MBhL2gtcC17cTnr6DmfHZeS0s2rTHjUTMMHfG7gO8SSdw+g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/js-sdsl": {
       "version": "4.3.0",
       "resolved": "https://registry.npmjs.org/js-sdsl/-/js-sdsl-4.3.0.tgz",
@@ -9185,10 +9382,25 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/json-schema-to-ts": {
+      "version": "2.7.2",
+      "resolved": "https://registry.npmjs.org/json-schema-to-ts/-/json-schema-to-ts-2.7.2.tgz",
+      "integrity": "sha512-R1JfqKqbBR4qE8UyBR56Ms30LL62/nlhoz+1UkfI/VE7p54Awu919FZ6ZUPG8zIa3XB65usPJgr1ONVncUGSaQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.18.3",
+        "@types/json-schema": "^7.0.9",
+        "ts-algebra": "^1.2.0"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
     "node_modules/json-schema-traverse": {
-      "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
-      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
       "dev": true,
       "license": "MIT"
     },
@@ -10001,6 +10213,16 @@
         "node": "^14.17.0 || ^16.13.0 || >=18.0.0"
       }
     },
+    "node_modules/normalize-path": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
+      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/nth-check": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz",
@@ -10522,6 +10744,16 @@
         "node": ">=18"
       }
     },
+    "node_modules/pluralize": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/pluralize/-/pluralize-8.0.0.tgz",
+      "integrity": "sha512-Nc3IT5yHzflTfbjgqWcCPpo7DaKy4FnpB0l/zCAW0Tc7jxAiuqSxHasntB3D7887LSrA93kDJ9IXovxJYxyLCA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
     "node_modules/pngjs": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/pngjs/-/pngjs-5.0.0.tgz",
@@ -11195,6 +11427,16 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/require-main-filename": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/require-main-filename/-/require-main-filename-2.0.0.tgz",
@@ -11571,6 +11813,16 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/safe-stable-stringify": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/safe-stable-stringify/-/safe-stable-stringify-2.5.0.tgz",
+      "integrity": "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
     "node_modules/safer-buffer": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
@@ -12513,6 +12765,13 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/ts-algebra": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/ts-algebra/-/ts-algebra-1.2.2.tgz",
+      "integrity": "sha512-kloPhf1hq3JbCPOTYoOWDKxebWjNb2o/LKnNfkWhxVVisFFmMJPPdJeGoGmM+iRLyoXAR61e08Pb+vUXINg8aA==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/ts-api-utils": {
       "version": "2.5.0",
       "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz",
@@ -12536,6 +12795,130 @@
         "node": ">=6.10"
       }
     },
+    "node_modules/ts-json-schema-generator": {
+      "version": "2.9.0",
+      "resolved": "https://registry.npmjs.org/ts-json-schema-generator/-/ts-json-schema-generator-2.9.0.tgz",
+      "integrity": "sha512-NR5ZE108uiPtBHBJNGnhwoUaUx5vWTDJzDFG9YlRoqxPU76n+5FClRh92dcGgysbe1smRmYalM9Saj97GW1J4Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/json-schema": "^7.0.15",
+        "commander": "^14.0.3",
+        "glob": "^13.0.6",
+        "json5": "^2.2.3",
+        "normalize-path": "^3.0.0",
+        "safe-stable-stringify": "^2.5.0",
+        "tslib": "^2.8.1",
+        "typescript": "^5.9.3"
+      },
+      "bin": {
+        "ts-json-schema-generator": "bin/ts-json-schema-generator.js"
+      },
+      "engines": {
+        "node": ">=22.0.0"
+      }
+    },
+    "node_modules/ts-json-schema-generator/node_modules/balanced-match": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
+      "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/ts-json-schema-generator/node_modules/brace-expansion": {
+      "version": "5.0.7",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.7.tgz",
+      "integrity": "sha512-7oFy703dxfY3/NLxC1fh2SUCQ0H9rmAY+5EpDVfXjUTTs+HEwR2nYaqLv+GWcTsumwxPfiz6CzCNkwXwBUwqCA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^4.0.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/ts-json-schema-generator/node_modules/commander": {
+      "version": "14.0.3",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-14.0.3.tgz",
+      "integrity": "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/ts-json-schema-generator/node_modules/glob": {
+      "version": "13.0.6",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz",
+      "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "minimatch": "^10.2.2",
+        "minipass": "^7.1.3",
+        "path-scurry": "^2.0.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/ts-json-schema-generator/node_modules/lru-cache": {
+      "version": "11.5.1",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.1.tgz",
+      "integrity": "sha512-RPimw/7aMdv2oqRrxKwvZXcPfwBrn/JZ2xYcY9Hus/6LaS3VOAKVWKWgNLCFSiOm1ESXinjsDlidVU7JlnCN2A==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/ts-json-schema-generator/node_modules/minimatch": {
+      "version": "10.2.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz",
+      "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "brace-expansion": "^5.0.5"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/ts-json-schema-generator/node_modules/path-scurry": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.2.tgz",
+      "integrity": "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "lru-cache": "^11.0.0",
+        "minipass": "^7.1.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/ts-json-schema-generator/node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "dev": true,
+      "license": "0BSD"
+    },
     "node_modules/ts-map": {
       "version": "1.0.3",
       "resolved": "https://registry.npmjs.org/ts-map/-/ts-map-1.0.3.tgz",
@@ -14246,6 +14629,13 @@
         "url": "https://github.com/sponsors/eemeli"
       }
     },
+    "node_modules/yaml-ast-parser": {
+      "version": "0.0.43",
+      "resolved": "https://registry.npmjs.org/yaml-ast-parser/-/yaml-ast-parser-0.0.43.tgz",
+      "integrity": "sha512-2PTINUwsRqSd+s8XxKaJWQlUuEMHJQyEuh2edBbW8KNJz0SJPwUSD2zRWqezFEdN7IzAgeuYHFUCF7o8zRdZ0A==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
     "node_modules/yargs": {
       "version": "15.4.1",
       "resolved": "https://registry.npmjs.org/yargs/-/yargs-15.4.1.tgz",
diff --git a/package.json b/package.json
index f6e3e24c8..2663c9838 100644
--- a/package.json
+++ b/package.json
@@ -3,7 +3,7 @@
   "description": "evcc UI",
   "author": "evcc-io",
   "scripts": {
-    "build": "vite build",
+    "build": "npm run openapi && vite build",
     "test": "cross-env TZ=Europe/Berlin NODE_OPTIONS=--no-experimental-webstorage vitest",
     "lint": "npm run lint:prettier && npm run lint:eslint && npm run lint:tsc && npm run lint:i18n",
     "lint:prettier": "prettier assets tests **/*.{yaml,sh} i18n/*.json --write",
@@ -11,6 +11,7 @@
     "lint:tsc": "vue-tsc --noEmit",
     "lint:i18n": "tsx i18n/check.ts",
     "dev": "vite",
+    "openapi": "tsx scripts/state-schema/index.ts",
     "playwright": "playwright test --ui",
     "playwright:ci": "cross-env CI=true playwright test",
     "simulator": "vite tests/simulator",
@@ -58,6 +59,7 @@
     "@eslint/js": "^9.39.4",
     "@jest/types": "^30.4.1",
     "@playwright/test": "^1.60.0",
+    "@redocly/openapi-core": "^2.38.0",
     "@storybook/vue3": "^10.4.4",
     "@storybook/vue3-vite": "^10.4.4",
     "@types/body-parser": "^1.19.6",
@@ -75,6 +77,8 @@
     "@vue/eslint-config-typescript": "^14.8.0",
     "@vue/test-utils": "^2.4.11",
     "@vue/tsconfig": "^0.9.1",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
     "body-parser": "^2.2.2",
     "cross-env": "^10.1.0",
     "eslint": "^9.39.4",
@@ -96,6 +100,7 @@
     "rollup-plugin-visualizer": "^7.0.1",
     "storybook": "^10.4.6",
     "terser": "^5.48.0",
+    "ts-json-schema-generator": "^2.9.0",
     "tsx": "^4.22.4",
     "typescript": "^5.9.3",
     "typescript-eslint-language-service": "^5.0.5",
@@ -105,6 +110,7 @@
     "vue-hot-reload-api": "^2.3.4",
     "vue-tsc": "^3.3.5",
     "wait-on": "^9.0.10",
-    "ws": "^8.21.0"
+    "ws": "^8.21.0",
+    "yaml": "^2.9.0"
   }
 }
diff --git a/scripts/state-schema/index.ts b/scripts/state-schema/index.ts
new file mode 100644
index 000000000..e543d15eb
--- /dev/null
+++ b/scripts/state-schema/index.ts
@@ -0,0 +1,33 @@
+import { buildSchemas } from "./schemas";
+import { writeStateSchemas, bundleMcpJson } from "./openapi";
+
+const command = process.argv[2] ?? "generate";
+
+switch (command) {
+  case "generate": {
+    const schemas = buildSchemas();
+    await writeStateSchemas(schemas);
+    await bundleMcpJson();
+    console.log(
+      `${Object.keys(schemas.defs).length} state schemas → openapi.state.yaml + mcp/openapi.json`
+    );
+    break;
+  }
+  case "dump": {
+    console.log(JSON.stringify(buildSchemas().defs, null, 2));
+    break;
+  }
+  case "validate": {
+    const source = process.argv[3];
+    if (!source) {
+      console.error("usage: npm run openapi -- validate <payload.json | url>");
+      process.exit(1);
+    }
+    const { validate } = await import("./validate");
+    if (!(await validate(source))) process.exit(1);
+    break;
+  }
+  default:
+    console.error(`unknown command: ${command}`);
+    process.exit(1);
+}
diff --git a/scripts/state-schema/openapi.ts b/scripts/state-schema/openapi.ts
new file mode 100644
index 000000000..0b70df457
--- /dev/null
+++ b/scripts/state-schema/openapi.ts
@@ -0,0 +1,40 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { parse, stringify } from "yaml";
+import prettier from "prettier";
+import { bundle, createConfig } from "@redocly/openapi-core";
+import type { StateSchemas } from "./schemas";
+
+const OPENAPI_PATH = "server/openapi.yaml";
+const STATE_PATH = "server/openapi.state.yaml";
+const MCP_JSON_PATH = "server/mcp/openapi.json";
+
+const HEADER = `# GENERATED FILE - DO NOT EDIT (source: assets/js/types/evcc.ts, update: npm run openapi)
+`;
+
+export async function writeStateSchemas(schemas: StateSchemas): Promise<void> {
+  const root = parse(readFileSync(OPENAPI_PATH, "utf8"));
+  const handWritten = new Set(Object.keys(root.components?.schemas ?? {}));
+  for (const name of Object.keys(schemas.defs)) {
+    if (handWritten.has(name)) {
+      throw new Error(`generated schema "${name}" collides with hand-written component`);
+    }
+  }
+
+  const doc =
+    HEADER +
+    stringify(
+      { components: { schemas: schemas.defs } },
+      { lineWidth: 0, aliasDuplicateObjects: false }
+    );
+
+  const config = await prettier.resolveConfig(STATE_PATH);
+  writeFileSync(STATE_PATH, await prettier.format(doc, { ...config, filepath: STATE_PATH }));
+}
+
+// inline the multi-file spec into the single json embedded by the MCP server
+export async function bundleMcpJson(): Promise<void> {
+  const { bundle: result } = await bundle({ ref: OPENAPI_PATH, config: await createConfig({}) });
+  const doc = result.parsed as { servers?: unknown };
+  delete doc.servers; // mcp server sets its own url
+  writeFileSync(MCP_JSON_PATH, JSON.stringify(doc, null, 2) + "\n");
+}
diff --git a/scripts/state-schema/schemas.ts b/scripts/state-schema/schemas.ts
new file mode 100644
index 000000000..9cc1358a1
--- /dev/null
+++ b/scripts/state-schema/schemas.ts
@@ -0,0 +1,221 @@
+import { createGenerator } from "ts-json-schema-generator";
+import type { Schema } from "ts-json-schema-generator";
+
+export interface StateSchemas {
+  rootName: string;
+  // schema per component name, root first, rest alphabetical
+  defs: Record<string, Schema>;
+}
+
+// enums use SCREAMING_SNAKE in the frontend, schema names follow openapi PascalCase convention
+const RENAME: Record<string, string> = {
+  CHARGE_MODE: "ChargeMode",
+  BATTERY_MODE: "BatteryMode",
+  CURRENCY: "Currency",
+  CHARGER_STATUS_REASON: "ChargerStatusReason",
+  PHASE_ACTION: "PhaseAction",
+  PV_ACTION: "PvAction",
+  SMART_COST_TYPE: "SmartCostType",
+  OCPP_STATION_STATUS: "OcppConnectionStatus",
+  MODBUS_BAUDRATE: "ModbusBaudrate",
+  MODBUS_COMSET: "ModbusComset",
+  MODBUS_PROXY_READONLY: "ModbusProxyReadonly",
+};
+
+const VALID_NAME = /^[a-zA-Z0-9._-]+$/;
+const ROOT = "State";
+
+function buildRawSchema(): Schema {
+  const generator = createGenerator({
+    path: "assets/js/types/evcc.ts",
+    tsconfig: "tsconfig.json",
+    type: ROOT,
+    jsDoc: "extended",
+    extraTags: ["internal"],
+    additionalProperties: true,
+    topRef: false,
+    skipTypeCheck: true,
+    sortProps: false,
+  });
+  return generator.createSchema(ROOT);
+}
+
+type AnySchema = any;
+
+function walk(node: any, visit: (schema: AnySchema) => void): void {
+  if (Array.isArray(node)) {
+    node.forEach((child) => walk(child, visit));
+  } else if (node && typeof node === "object") {
+    visit(node);
+    Object.values(node).forEach((child) => walk(child, visit));
+  }
+}
+
+// remove properties tagged @internal, they are UI-only and not part of the API payload
+function stripInternal(schema: AnySchema): void {
+  walk(schema, (node) => {
+    if (!node.properties) return;
+    for (const [key, prop] of Object.entries<AnySchema>(node.properties)) {
+      if (prop?.internal === true) {
+        delete node.properties[key];
+        if (Array.isArray(node.required)) {
+          node.required = node.required.filter((r: string) => r !== key);
+          if (node.required.length === 0) delete node.required;
+        }
+      }
+    }
+  });
+}
+
+function collectRefs(schema: AnySchema): Set<string> {
+  const refs = new Set<string>();
+  walk(schema, (node) => {
+    if (typeof node.$ref === "string") {
+      refs.add(decodeURIComponent(node.$ref.replace("#/definitions/", "")));
+    }
+  });
+  return refs;
+}
+
+// drop definitions that became unreachable after stripping @internal properties
+function reachableDefs(
+  root: AnySchema,
+  defs: Record<string, AnySchema>
+): Record<string, AnySchema> {
+  const keep: Record<string, AnySchema> = {};
+  const queue = [...collectRefs(root)];
+  while (queue.length > 0) {
+    const name = queue.shift()!;
+    if (keep[name] || !defs[name]) continue;
+    keep[name] = defs[name];
+    queue.push(...collectRefs(defs[name]));
+  }
+  return keep;
+}
+
+// convert json-schema null unions to `nullable: true`, the 3.0 style used across openapi.yaml
+// (kin-openapi, which validates the spec in CI, does not support 3.1 type arrays)
+function normalizeNullables(schema: AnySchema): void {
+  walk(schema, (node) => {
+    if (Array.isArray(node.type) && node.type.includes("null")) {
+      const rest = node.type.filter((t: string) => t !== "null");
+      if (rest.length !== 1) throw new Error(`unsupported type union ${node.type}`);
+      node.type = rest[0];
+      node.nullable = true;
+    }
+    if (Array.isArray(node.anyOf) && node.anyOf.some((b: AnySchema) => b.type === "null")) {
+      const rest = node.anyOf.filter((b: AnySchema) => b.type !== "null");
+      delete node.anyOf;
+      node.nullable = true;
+      if (rest.length === 1 && !rest[0].$ref) {
+        Object.assign(node, rest[0]);
+      } else {
+        node.allOf = rest;
+      }
+    }
+    // openapi 3.0 has no `const`, use a single-value enum
+    if ("const" in node) {
+      node.enum = [node.const];
+      delete node.const;
+    }
+    // openapi 3.0 uses a singular example
+    if (Array.isArray(node.examples)) {
+      node.example = node.examples[0];
+      delete node.examples;
+    }
+  });
+}
+
+// point $refs at the final openapi component names
+function rewriteRefs(schema: AnySchema, finalNames: Map<string, string>): void {
+  walk(schema, (node) => {
+    if (typeof node.$ref !== "string" || node.$ref.startsWith("#/components/")) return;
+    const name = decodeURIComponent(node.$ref.replace("#/definitions/", ""));
+    const renamed = finalNames.get(name);
+    if (!renamed) throw new Error(`unresolved $ref "${node.$ref}"`);
+    node.$ref = `#/components/schemas/${renamed}`;
+  });
+}
+
+export function buildSchemas(): StateSchemas {
+  const raw = buildRawSchema() as AnySchema;
+  const { definitions = {}, $schema, ...root } = raw;
+
+  stripInternal(root);
+  Object.values(definitions as Record<string, AnySchema>).forEach(stripInternal);
+
+  const defs = reachableDefs(root, definitions);
+
+  const finalNames = new Map<string, string>();
+  for (const name of Object.keys(defs)) {
+    const renamed = RENAME[name] ?? name;
+    if (!VALID_NAME.test(renamed)) {
+      throw new Error(`invalid component name "${renamed}", rename the type in evcc.ts`);
+    }
+    if ([...finalNames.values()].includes(renamed)) {
+      throw new Error(`duplicate component name "${renamed}" after renaming`);
+    }
+    finalNames.set(name, renamed);
+  }
+
+  rewriteRefs(root, finalNames);
+  Object.values(defs).forEach((schema) => rewriteRefs(schema, finalNames));
+
+  normalizeNullables(root);
+  Object.values(defs).forEach(normalizeNullables);
+
+  const result: Record<string, Schema> = { [ROOT]: root };
+  for (const [name, schema] of Object.entries(defs)
+    .map(([name, schema]) => [finalNames.get(name)!, schema] as const)
+    .sort(([a], [b]) => a.localeCompare(b))) {
+    result[name] = schema;
+  }
+
+  const serialized = JSON.stringify(result);
+  if (serialized.includes("#/definitions/")) {
+    throw new Error("unrewritten $ref to #/definitions/ left in output");
+  }
+
+  const ordered = Object.fromEntries(
+    Object.entries(result).map(([name, schema]) => [name, orderKeys(schema)])
+  );
+
+  return { rootName: ROOT, defs: ordered };
+}
+
+const KEY_ORDER = [
+  "$ref",
+  "description",
+  "type",
+  "nullable",
+  "enum",
+  "format",
+  "example",
+  "items",
+  "properties",
+  "required",
+  "additionalProperties",
+  "anyOf",
+  "allOf",
+];
+
+// stable key order for readable yaml diffs, property order itself is preserved
+function orderKeys(node: any): any {
+  if (Array.isArray(node)) return node.map(orderKeys);
+  if (!node || typeof node !== "object") return node;
+  const keys = Object.keys(node).sort((a, b) => {
+    const ia = KEY_ORDER.indexOf(a);
+    const ib = KEY_ORDER.indexOf(b);
+    return (ia === -1 ? KEY_ORDER.length : ia) - (ib === -1 ? KEY_ORDER.length : ib);
+  });
+  return Object.fromEntries(
+    keys.map((key) => [
+      key,
+      key === "properties" ? mapValues(node[key], orderKeys) : orderKeys(node[key]),
+    ])
+  );
+}
+
+function mapValues(obj: Record<string, any>, fn: (v: any) => any): Record<string, any> {
+  return Object.fromEntries(Object.entries(obj).map(([k, v]) => [k, fn(v)]));
+}
diff --git a/scripts/state-schema/validate.ts b/scripts/state-schema/validate.ts
new file mode 100644
index 000000000..1d568d929
--- /dev/null
+++ b/scripts/state-schema/validate.ts
@@ -0,0 +1,114 @@
+import { readFileSync } from "node:fs";
+import { parse } from "yaml";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import addFormats from "ajv-formats";
+
+const STATE_SCHEMAS_PATH = "server/openapi.state.yaml";
+
+// intentionally undocumented experimental structures
+const IGNORE = new Set(["$.evopt", "$.evopt-batteries"]);
+
+type AnySchema = any;
+
+function resolve(schema: AnySchema, schemas: Record<string, AnySchema>): AnySchema {
+  if (typeof schema?.$ref === "string") {
+    return resolve(schemas[schema.$ref.split("/").pop()!], schemas);
+  }
+  return schema ?? {};
+}
+
+// report payload keys that have no schema property, additionalProperties:true hides them from ajv
+function coverage(
+  schema: AnySchema,
+  data: any,
+  path: string,
+  schemas: Record<string, AnySchema>,
+  report: Set<string>
+): void {
+  const s = resolve(schema, schemas);
+  if (s.anyOf) {
+    if (data === null) return;
+    const branch = s.anyOf.find((b: AnySchema) => resolve(b, schemas).type !== "null");
+    if (branch) coverage(branch, data, path, schemas, report);
+    return;
+  }
+  if (Array.isArray(data)) {
+    if (s.items) data.forEach((item) => coverage(s.items, item, `${path}[]`, schemas, report));
+    return;
+  }
+  if (data !== null && typeof data === "object") {
+    if (!s.properties) return;
+    for (const key of Object.keys(data)) {
+      if (s.properties[key]) {
+        coverage(s.properties[key], data[key], `${path}.${key}`, schemas, report);
+      } else if (!IGNORE.has(`${path}.${key}`)) {
+        report.add(`${path}.${key}`);
+      }
+    }
+  }
+}
+
+// openapi uses `nullable: true`, json schema expects explicit null in the type
+function expandNullable(node: any): void {
+  if (Array.isArray(node)) {
+    node.forEach(expandNullable);
+  } else if (node && typeof node === "object") {
+    if (node.nullable === true) {
+      delete node.nullable;
+      if (typeof node.type === "string") {
+        node.type = [node.type, "null"];
+      } else if (Array.isArray(node.allOf)) {
+        node.anyOf = [...node.allOf, { type: "null" }];
+        delete node.allOf;
+      }
+    }
+    Object.values(node).forEach(expandNullable);
+  }
+}
+
+// validate a /api/state payload against the State schema in server/openapi.state.yaml
+export function validateState(payload: any): { errors: string[]; undocumented: string[] } {
+  const doc = parse(readFileSync(STATE_SCHEMAS_PATH, "utf8"));
+  const schemas: Record<string, AnySchema> = doc.components.schemas;
+  expandNullable(schemas);
+
+  const ajv = new Ajv2020({ strict: false, allErrors: true });
+  addFormats(ajv);
+  const validateFn = ajv.compile({
+    $ref: "#/components/schemas/State",
+    components: { schemas },
+  });
+
+  const errors = validateFn(payload)
+    ? []
+    : (validateFn.errors ?? []).map((err) => `${err.instancePath || "/"} ${err.message}`);
+
+  const undocumented = new Set<string>();
+  coverage(schemas["State"], payload, "$", schemas, undocumented);
+
+  return { errors, undocumented: [...undocumented].sort() };
+}
+
+export async function validate(source: string): Promise<boolean> {
+  let payload: any;
+  if (source.startsWith("http")) {
+    const res = await fetch(`${source.replace(/\/$/, "")}/api/state`);
+    payload = await res.json();
+  } else {
+    payload = JSON.parse(readFileSync(source, "utf8"));
+  }
+
+  const { errors, undocumented } = validateState(payload);
+
+  if (errors.length > 0) {
+    console.error(`${source}: schema violations`);
+    for (const err of errors.slice(0, 30)) console.error(`  ${err}`);
+  }
+  if (undocumented.length > 0) {
+    console.log(`${source}: ${undocumented.length} undocumented keys`);
+    for (const key of undocumented) console.log(`  ${key}`);
+  }
+  if (errors.length === 0 && undocumented.length === 0) console.log(`${source}: ok`);
+
+  return errors.length === 0;
+}
diff --git a/server/mcp/openapi.json b/server/mcp/openapi.json
index fa4803c03..1c221c02c 100644
--- a/server/mcp/openapi.json
+++ b/server/mcp/openapi.json
@@ -1,3046 +1,17 @@
 {
-  "components": {
-    "parameters": {
-      "adminPassword": {
-        "description": "Admin password (required for session auth, not needed for API key)",
-        "in": "header",
-        "name": "X-Admin-Password",
-        "schema": {
-          "$ref": "#/components/schemas/Password"
-        }
-      },
-      "batteryMode": {
-        "in": "path",
-        "name": "batteryMode",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/BatteryMode"
-        }
-      },
-      "costLimit": {
-        "description": "Cost limit in configured currency (default EUR) or CO2 limit in g/kWh",
-        "example": 0.25,
-        "in": "path",
-        "name": "cost",
-        "required": true,
-        "schema": {
-          "type": "number"
-        }
-      },
-      "current": {
-        "description": "Electric current in A",
-        "in": "path",
-        "name": "current",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Current"
-        }
-      },
-      "delay": {
-        "description": "Duration in seconds.",
-        "in": "path",
-        "name": "delay",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Delay"
-        }
-      },
-      "enable": {
-        "description": "Charging mode.",
-        "in": "path",
-        "name": "enable",
-        "required": true,
-        "schema": {
-          "enum": [
-            "true",
-            "false",
-            "1",
-            "0"
-          ],
-          "type": "string"
-        }
-      },
-      "energy": {
-        "description": "Energy in kWh",
-        "in": "path",
-        "name": "energy",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Energy"
-        }
-      },
-      "hourMinuteTime": {
-        "description": "Time in `HOURS:MINUTES` format",
-        "in": "path",
-        "name": "hourMinuteTime",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/HourMinuteTime"
-        }
-      },
-      "id": {
-        "description": "Loadpoint index starting at 1",
-        "in": "path",
-        "name": "id",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Id"
-        }
-      },
-      "logAreas": {
-        "description": "Comma-separated list of log areas",
-        "explode": true,
-        "in": "query",
-        "name": "areas",
-        "schema": {
-          "$ref": "#/components/schemas/LogAreas"
-        }
-      },
-      "logLevel": {
-        "description": "Log level",
-        "in": "query",
-        "name": "level",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/LogLevel"
-        }
-      },
-      "mode": {
-        "in": "path",
-        "name": "mode",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Mode"
-        }
-      },
-      "phases": {
-        "description": "Number of phases. (0: auto, 1: 1-phase, 3: 3-phase)",
-        "in": "path",
-        "name": "phases",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Phases"
-        }
-      },
-      "power": {
-        "description": "Power in W",
-        "in": "path",
-        "name": "power",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Power"
-        }
-      },
-      "soc": {
-        "description": "SOC in %",
-        "in": "path",
-        "name": "soc",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Soc"
-        }
-      },
-      "temp": {
-        "description": "Temperature in °C",
-        "in": "path",
-        "name": "temp",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Temp"
-        }
-      },
-      "threshold": {
-        "description": "Power in W",
-        "in": "path",
-        "name": "threshold",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Power"
-        }
-      },
-      "timestamp": {
-        "description": "Timestamp in RFC3339 format",
-        "in": "path",
-        "name": "timestamp",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Timestamp"
-        }
-      },
-      "timezone": {
-        "in": "path",
-        "name": "timezone",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/IANATimeZone"
-        }
-      },
-      "vehicleName": {
-        "description": "Vehicle name",
-        "in": "path",
-        "name": "name",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/VehicleName"
-        }
-      },
-      "weekdays": {
-        "description": "The Weekdays",
-        "in": "path",
-        "name": "weekdays",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Weekdays"
-        }
-      }
-    },
-    "responses": {
-      "BatteryModeResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "description": "Battery mode. 0: unknown, 1: normal, 2: hold, 3: charge, 4: holdcharge",
-              "maximum": 4,
-              "minimum": 0,
-              "type": "integer"
-            }
-          }
-        },
-        "description": "Battery mode"
-      },
-      "BlankResponse": {
-        "description": "Success - Blank response"
-      },
-      "BooleanResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "boolean"
-            }
-          }
-        },
-        "description": "Success - Boolean result"
-      },
-      "EmptyResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "object"
-            }
-          }
-        },
-        "description": "Success - Empty result"
-      },
-      "IntegerResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "integer"
-            }
-          }
-        },
-        "description": "Success - Integer result"
-      },
-      "NanoSecondsResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "integer"
-            }
-          }
-        },
-        "description": "Success - Number result - Unit is **nanoseconds**"
-      },
-      "NullResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "description": "Value is always null",
-              "nullable": true,
-              "type": "object"
-            }
-          }
-        },
-        "description": "Success - Null result"
-      },
-      "NumberResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "number"
-            }
-          }
-        },
-        "description": "Success - Number result"
-      },
-      "PlanRatesResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/PlanRates"
-            }
-          }
-        },
-        "description": "Success - PlanRates result"
-      },
-      "SocResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "properties": {
-                "soc": {
-                  "$ref": "#/components/schemas/Soc"
-                }
-              },
-              "type": "object"
-            }
-          }
-        },
-        "description": "Success - Soc result"
-      },
-      "SuccessResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "example": "OK",
-              "type": "string"
-            }
-          }
-        },
-        "description": "Success"
-      },
-      "Unauthorized": {
-        "content": {
-          "text/plain": {
-            "schema": {
-              "enum": [
-                "Unauthorized"
-              ],
-              "type": "string"
-            }
-          }
-        },
-        "description": "Unauthorized - Login and try again"
-      }
-    },
-    "schemas": {
-      "BatteryMode": {
-        "description": "Battery mode",
-        "enum": [
-          "unknown",
-          "normal",
-          "hold",
-          "charge",
-          "holdcharge"
-        ],
-        "example": "normal",
-        "type": "string"
-      },
-      "ChangePassword": {
-        "properties": {
-          "current": {
-            "$ref": "#/components/schemas/Password"
-          },
-          "new": {
-            "$ref": "#/components/schemas/Password"
-          }
-        },
-        "type": "object"
-      },
-      "ChargingSessions": {
-        "description": "Charging sessions",
-        "items": {
-          "properties": {
-            "chargedEnergy": {
-              "description": "Charged energy in kWh",
-              "type": "number"
-            },
-            "created": {
-              "$ref": "#/components/schemas/Timestamp"
-            },
-            "finished": {
-              "$ref": "#/components/schemas/Timestamp"
-            },
-            "id": {
-              "$ref": "#/components/schemas/Id"
-            },
-            "loadpoint": {
-              "$ref": "#/components/schemas/LoadpointName"
-            },
-            "meterStart": {
-              "description": "Meter reading at start of charging session",
-              "nullable": true,
-              "type": "number"
-            },
-            "meterStop": {
-              "description": "Meter reading at end of charging session",
-              "nullable": true,
-              "type": "number"
-            },
-            "odometer": {
-              "$ref": "#/components/schemas/Odometer"
-            },
-            "vehicle": {
-              "$ref": "#/components/schemas/VehicleName"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "Current": {
-        "description": "Electric current in A",
-        "example": 16,
-        "minimum": 0,
-        "type": "number"
-      },
-      "Delay": {
-        "description": "Duration in seconds.",
-        "example": 60,
-        "type": "integer"
-      },
-      "Energy": {
-        "description": "Energy in kWh",
-        "example": 25.5,
-        "minimum": 0,
-        "type": "number"
-      },
-      "GridSessions": {
-        "description": "Grid limitation sessions",
-        "items": {
-          "properties": {
-            "chargeDuration": {
-              "description": "Duration of active charging",
-              "type": "number"
-            },
-            "co2PerKWh": {
-              "description": "Average CO₂ emissions per kWh",
-              "type": "number"
-            },
-            "created": {
-              "$ref": "#/components/schemas/Timestamp"
-            },
-            "finished": {
-              "$ref": "#/components/schemas/Timestamp"
-            },
-            "gridPower": {
-              "description": "Grid power in watts",
-              "type": "number"
-            },
-            "id": {
-              "$ref": "#/components/schemas/Id"
-            },
-            "limitPower": {
-              "description": "Limitation power in watts",
-              "type": "number"
-            },
-            "price": {
-              "description": "Total price of the session",
-              "type": "number"
-            },
-            "pricePerKWh": {
-              "description": "Average price per kWh",
-              "type": "number"
-            },
-            "solarPercentage": {
-              "description": "Solar percentage of the session",
-              "type": "number"
-            },
-            "type": {
-              "description": "Type of grid limitation event",
-              "enum": [
-                "consumption",
-                "feedin"
-              ],
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "HourMinuteTime": {
-        "description": "Time in `HH:MM` format",
-        "example": "12:30",
-        "format": "HH:MM",
-        "pattern": "[0-1][0-9]:[0-5][0-9]",
-        "type": "string"
-      },
-      "IANATimeZone": {
-        "description": "Timezone in IANA format",
-        "example": "Europe/Berlin",
-        "externalDocs": {
-          "url": "https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List"
-        },
-        "type": "string"
-      },
-      "Id": {
-        "description": "Loadpoint index starting at 1.",
-        "example": 1,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "LoadpointName": {
-        "example": "Garage",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#title"
-        },
-        "type": "string"
-      },
-      "LogArea": {
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/log#levels"
-        },
-        "type": "string"
-      },
-      "LogAreas": {
-        "example": [
-          "lp-1",
-          "site",
-          "db"
-        ],
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/log#levels"
-        },
-        "items": {
-          "$ref": "#/components/schemas/LogArea"
-        },
-        "type": "array"
-      },
-      "LogLevel": {
-        "enum": [
-          "FATAL",
-          "ERROR",
-          "WARN",
-          "INFO",
-          "DEBUG",
-          "TRACE"
-        ],
-        "example": "DEBUG",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/log#log"
-        },
-        "type": "string"
-      },
-      "Mode": {
-        "description": "Charging mode.",
-        "enum": [
-          "off",
-          "now",
-          "minpv",
-          "pv"
-        ],
-        "type": "string"
-      },
-      "Odometer": {
-        "description": "Vehicle odometer reading in kilometers",
-        "nullable": true,
-        "type": "number"
-      },
-      "Password": {
-        "description": "Admin password",
-        "type": "string"
-      },
-      "Phases": {
-        "description": "Number of phases. (0: auto, 1: 1-phase, 3: 3-phase)",
-        "enum": [
-          "0",
-          "1",
-          "3"
-        ],
-        "example": "3",
-        "type": "string"
-      },
-      "PlanRates": {
-        "properties": {
-          "duration": {
-            "description": "Duration in s",
-            "minimum": 0,
-            "type": "integer"
-          },
-          "plan": {
-            "$ref": "#/components/schemas/Rates"
-          },
-          "planTime": {
-            "$ref": "#/components/schemas/Timestamp"
-          },
-          "power": {
-            "$ref": "#/components/schemas/Power"
-          }
-        },
-        "type": "object"
-      },
-      "PlanStrategy": {
-        "description": "Charging plan strategy configuration",
-        "properties": {
-          "continuous": {
-            "description": "Force continuous planning",
-            "type": "boolean"
-          },
-          "precondition": {
-            "description": "Precondition duration in seconds",
-            "minimum": 0,
-            "type": "integer"
-          }
-        },
-        "type": "object"
-      },
-      "Power": {
-        "description": "Power in W",
-        "example": 2500,
-        "minimum": 0,
-        "type": "number"
-      },
-      "Precondition": {
-        "description": "Late charging duration in seconds.",
-        "example": 3600,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "Rate": {
-        "description": "A charging interval",
-        "properties": {
-          "end": {
-            "$ref": "#/components/schemas/Timestamp"
-          },
-          "start": {
-            "$ref": "#/components/schemas/Timestamp"
-          },
-          "value": {
-            "description": "Cost",
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "type": "object"
-      },
-      "Rates": {
-        "items": {
-          "$ref": "#/components/schemas/Rate"
-        },
-        "type": "array"
-      },
-      "RepeatingPlan": {
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans#repeating-plans"
-        },
-        "properties": {
-          "active": {
-            "description": "Set plan active.",
-            "type": "boolean"
-          },
-          "soc": {
-            "$ref": "#/components/schemas/Soc"
-          },
-          "time": {
-            "$ref": "#/components/schemas/HourMinuteTime"
-          },
-          "tz": {
-            "$ref": "#/components/schemas/IANATimeZone"
-          },
-          "weekdays": {
-            "$ref": "#/components/schemas/Weekdays"
-          }
-        },
-        "type": "object"
-      },
-      "Soc": {
-        "description": "SOC in %",
-        "example": 60,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "State": {
-        "description": "The actual state structure is not documented yet. Most values should be self-explanatory. Note: While the overall structure is quite stable, details may change between releases.",
-        "type": "object"
-      },
-      "StaticEnergyPlan": {
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans#energy-amount-plan"
-        },
-        "properties": {
-          "energy": {
-            "$ref": "#/components/schemas/Energy"
-          },
-          "time": {
-            "$ref": "#/components/schemas/Timestamp"
-          }
-        },
-        "type": "object"
-      },
-      "StaticSocPlan": {
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans#create-charging-plan"
-        },
-        "properties": {
-          "soc": {
-            "$ref": "#/components/schemas/Soc"
-          },
-          "time": {
-            "$ref": "#/components/schemas/Timestamp"
-          }
-        },
-        "type": "object"
-      },
-      "Temp": {
-        "description": "Temperature in °C",
-        "example": 50,
-        "minimum": 0,
-        "type": "number"
-      },
-      "Timestamp": {
-        "description": "Timestamp in RFC3339 format",
-        "format": "date-time",
-        "type": "string"
-      },
-      "VehicleName": {
-        "example": "vehicle_1",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/vehicles#name"
-        },
-        "minLength": 1,
-        "pattern": "[a-zA-Z0-9_.:-]+",
-        "type": "string"
-      },
-      "VehicleTitle": {
-        "example": "blauer e-Golf",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/vehicles#title"
-        },
-        "type": "string"
-      },
-      "Weekdays": {
-        "description": "The Weekdays",
-        "example": [
-          1,
-          3,
-          4
-        ],
-        "items": {
-          "description": "0: Sunday, 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday",
-          "maximum": 6,
-          "minimum": 0,
-          "type": "integer"
-        },
-        "type": "array",
-        "uniqueItems": true
-      }
-    },
-    "securitySchemes": {
-      "bearerAuth": {
-        "description": "Long-lived API key (prefixed `evcc_`, managed via /auth/apikey).\nGrants access to /api/db/* without requiring the X-Admin-Password header.\n",
-        "scheme": "bearer",
-        "type": "http"
-      },
-      "cookieAuth": {
-        "in": "cookie",
-        "name": "auth",
-        "type": "apiKey"
-      }
-    }
-  },
+  "openapi": "3.1.0",
   "info": {
+    "title": "evcc",
+    "description": "Solar charging. Super simple.",
+    "version": "0.2.0",
     "contact": {
       "url": "https://github.com/evcc-io/evcc"
-    },
-    "description": "Solar charging. Super simple.",
-    "title": "evcc",
-    "version": "0.2.0"
-  },
-  "openapi": "3.1.0",
-  "paths": {
-    "/auth/apikey": {
-      "get": {
-        "description": "Reports whether an API key has been generated. The key itself is\nonly returned once at creation time (POST), never on subsequent\nreads.\n",
-        "operationId": "getApiKeyStatus",
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "configured": {
-                      "type": "boolean"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "API key status",
-        "tags": [
-          "auth"
-        ]
-      },
-      "post": {
-        "description": "Generates a fresh API key, replacing any existing one. The\nreturned key is shown only once; store it immediately.\n\nEven when the request is authenticated via API key (Bearer), the\nadmin password must be supplied in the request body to prevent a\nleaked key from rotating itself. The password check is skipped\nwhen the server is started with `--disable-auth`.\n",
-        "operationId": "regenerateApiKey",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "properties": {
-                  "password": {
-                    "$ref": "#/components/schemas/Password"
-                  }
-                },
-                "type": "object"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "key": {
-                      "description": "The new API key (cleartext, shown once).",
-                      "example": "evcc_aB3xYz7k0Pq2sN5mWtR4",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
-          },
-          "401": {
-            "description": "Invalid admin password"
-          },
-          "403": {
-            "description": "Forbidden in demo mode"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "Generate or rotate the API key",
-        "tags": [
-          "auth"
-        ]
-      }
-    },
-    "/auth/login": {
-      "post": {
-        "description": "Administrator login. Returns authorization cookie required for all protected endpoints.",
-        "operationId": "login",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "properties": {
-                  "password": {
-                    "$ref": "#/components/schemas/Password"
-                  }
-                },
-                "type": "object"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "description": "Success",
-            "headers": {
-              "Set-Cookie": {
-                "description": "The authorization cookie",
-                "schema": {
-                  "example": "auth=ey...qY; Path=/; Expires=Fri, 04 Apr 2025 14:35:37 GMT; HttpOnly; SameSite=Strict",
-                  "type": "string"
-                }
-              }
-            }
-          },
-          "401": {
-            "description": "Invalid password provided"
-          }
-        },
-        "summary": "Login",
-        "tags": [
-          "auth"
-        ]
-      }
-    },
-    "/auth/logout": {
-      "post": {
-        "description": "Logout and delete authorization cookie",
-        "operationId": "logout",
-        "responses": {
-          "200": {
-            "description": "Success",
-            "headers": {
-              "Set-Cookie": {
-                "description": "The authorization cookie",
-                "schema": {
-                  "enum": [
-                    "auth=; Path=/; HttpOnly"
-                  ],
-                  "type": "string"
-                }
-              }
-            }
-          }
-        },
-        "summary": "Logout",
-        "tags": [
-          "auth"
-        ]
-      }
-    },
-    "/auth/password": {
-      "put": {
-        "description": "Changes the admin password.",
-        "operationId": "changePassword",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ChangePassword"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "202": {
-            "description": "Success"
-          },
-          "400": {
-            "description": "Invalid password provided"
-          }
-        },
-        "summary": "Change admin password",
-        "tags": [
-          "auth"
-        ]
-      }
-    },
-    "/auth/status": {
-      "get": {
-        "description": "Whether the current user is logged in.",
-        "operationId": "getAuthStatus",
-        "responses": {
-          "200": {
-            "content": {
-              "text/plain": {
-                "schema": {
-                  "enum": [
-                    "true",
-                    "false"
-                  ],
-                  "type": "string"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Authentication status",
-        "tags": [
-          "auth"
-        ]
-      }
-    },
-    "/batterydischargecontrol/{enable}": {
-      "post": {
-        "description": "Prevent home battery discharge during vehicle fast charging.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/battery"
-        },
-        "operationId": "setBatteryDischargeControl",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/enable"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/BooleanResult"
-          }
-        },
-        "summary": "Control battery-discharge",
-        "tags": [
-          "battery"
-        ]
-      }
-    },
-    "/batterygridchargelimit": {
-      "delete": {
-        "description": "Remove battery grid charge limit.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/battery"
-        },
-        "operationId": "removeBatteryGridChargeLimit",
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
-          }
-        },
-        "summary": "Remove battery grid charge limit",
-        "tags": [
-          "battery"
-        ]
-      }
-    },
-    "/batterygridchargelimit/{cost}": {
-      "post": {
-        "description": "Charge home battery from grid when price or emissions are below the threshold. Uses price if a dynamic tariff exists. Uses emissions if a CO₂-tariff is configured. Ignored otherwise.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/battery"
-        },
-        "operationId": "setBatteryGridChargeLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/costLimit"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Set battery grid charge limit",
-        "tags": [
-          "battery"
-        ]
-      }
-    },
-    "/batterymode": {
-      "delete": {
-        "description": "Default evcc control behavior is restored",
-        "operationId": "disableExternalBatteryControl",
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/BatteryModeResult"
-          }
-        },
-        "summary": "Disable external battery control",
-        "tags": [
-          "battery"
-        ]
-      }
-    },
-    "/batterymode/{batteryMode}": {
-      "post": {
-        "description": "Directly controls the mode of all controllable batteries. evcc behavior like 'price limit' or 'prevent discharge while fast charging' is overruled. External mode resets after 60s. The external system has to call this endpoint regularly.",
-        "operationId": "setExternalBatteryMode",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/batteryMode"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/BatteryModeResult"
-          }
-        },
-        "summary": "Set external battery mode",
-        "tags": [
-          "battery"
-        ]
-      }
-    },
-    "/buffersoc/{soc}": {
-      "post": {
-        "description": "Set battery buffer SoC.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/battery"
-        },
-        "operationId": "setBufferSoc",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Set battery buffer SoC",
-        "tags": [
-          "battery"
-        ]
-      }
-    },
-    "/bufferstartsoc/{soc}": {
-      "post": {
-        "description": "Set battery buffer start SoC.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/battery"
-        },
-        "operationId": "setBufferStartSoc",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Set battery buffer start SoC",
-        "tags": [
-          "battery"
-        ]
-      }
-    },
-    "/db/backup": {
-      "get": {
-        "description": "Downloads the SQLite database as a backup file. Session users must supply the admin password in the X-Admin-Password header. API key holders via Bearer token are exempt.",
-        "operationId": "downloadBackup",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/adminPassword"
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/octet-stream": {
-                "schema": {
-                  "format": "binary",
-                  "type": "string"
-                }
-              }
-            },
-            "description": "SQLite database file"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "Download database backup",
-        "tags": [
-          "db"
-        ]
-      }
-    },
-    "/db/reset": {
-      "post": {
-        "description": "Selectively deletes sessions and/or settings from the database. Session users must supply the admin password in the X-Admin-Password header. API key holders via Bearer token are exempt. The instance restarts after a successful reset.",
-        "operationId": "resetDatabase",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/adminPassword"
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "properties": {
-                  "sessions": {
-                    "description": "Delete all charging sessions",
-                    "type": "boolean"
-                  },
-                  "settings": {
-                    "description": "Delete all settings, configs, and meters",
-                    "type": "boolean"
-                  }
-                },
-                "type": "object"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "204": {
-            "description": "Reset successful, instance is restarting"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "Reset database",
-        "tags": [
-          "db"
-        ]
-      }
-    },
-    "/db/restore": {
-      "post": {
-        "description": "Restores the database from a previously downloaded backup file. Session users must supply the admin password in the X-Admin-Password header. API key holders via Bearer token are exempt. The instance restarts after a successful restore.",
-        "operationId": "restoreBackup",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/adminPassword"
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "multipart/form-data": {
-              "schema": {
-                "properties": {
-                  "file": {
-                    "description": "SQLite database backup file",
-                    "format": "binary",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "file"
-                ],
-                "type": "object"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "204": {
-            "description": "Restore successful, instance is restarting"
-          },
-          "400": {
-            "description": "Invalid file or missing fields"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "Restore database backup",
-        "tags": [
-          "db"
-        ]
-      }
-    },
-    "/gridsessions": {
-      "get": {
-        "description": "Returns a list of HEMS grid limitation events.",
-        "operationId": "getGridSessions",
-        "parameters": [
-          {
-            "description": "Response format (default json)",
-            "in": "query",
-            "name": "format",
-            "schema": {
-              "enum": [
-                "csv"
-              ],
-              "type": "string"
-            }
-          },
-          {
-            "description": "Language (defaults to accept header)",
-            "in": "query",
-            "name": "lang",
-            "schema": {
-              "example": "de",
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/GridSessions"
-                }
-              },
-              "text/csv": {
-                "schema": {
-                  "description": "Download csv-file",
-                  "format": "binary",
-                  "type": "string"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Grid limitation sessions",
-        "tags": [
-          "sessions"
-        ]
-      }
-    },
-    "/history/energy": {
-      "get": {
-        "description": "Returns aggregated energy history data. Aggregate granularity defaults to 15 minutes. Supports CSV export.",
-        "operationId": "getEnergyHistory",
-        "parameters": [
-          {
-            "description": "Start time (RFC3339)",
-            "in": "query",
-            "name": "from",
-            "schema": {
-              "example": "2026-07-01T00:00:00Z",
-              "format": "date-time",
-              "type": "string"
-            }
-          },
-          {
-            "description": "End time (RFC3339)",
-            "in": "query",
-            "name": "to",
-            "schema": {
-              "example": "2026-07-02T00:00:00Z",
-              "format": "date-time",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Aggregation interval. Examples: 15m, 1h, day, month",
-            "in": "query",
-            "name": "aggregate",
-            "schema": {
-              "default": "15m",
-              "example": "1h",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Group results by loadpoint",
-            "in": "query",
-            "name": "grouped",
-            "schema": {
-              "default": false,
-              "example": false,
-              "type": "boolean"
-            }
-          },
-          {
-            "description": "Filter by entity group",
-            "in": "query",
-            "name": "group",
-            "schema": {
-              "enum": [
-                "forecast",
-                "battery",
-                "grid",
-                "pv",
-                "home",
-                "loadpoint",
-                "meter",
-                "consumer"
-              ],
-              "example": "battery",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Filter by entity name",
-            "in": "query",
-            "name": "name",
-            "schema": {
-              "example": "db:8",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Filter by entity title",
-            "in": "query",
-            "name": "title",
-            "schema": {
-              "example": "Battery",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Response format",
-            "in": "query",
-            "name": "format",
-            "schema": {
-              "default": "json",
-              "enum": [
-                "json",
-                "csv"
-              ],
-              "example": "json",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Language for CSV column headers (BCP 47, e.g. de, en). Defaults to Accept-Language header.",
-            "in": "query",
-            "name": "lang",
-            "schema": {
-              "example": "de",
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                }
-              },
-              "text/csv": {
-                "schema": {
-                  "type": "string"
-                }
-              }
-            },
-            "description": "Energy history data"
-          },
-          "400": {
-            "description": "Invalid parameters or database offline"
-          }
-        },
-        "summary": "Energy history",
-        "tags": [
-          "experimental"
-        ]
-      }
-    },
-    "/loadpoints/{id}/batteryboost/{enable}": {
-      "post": {
-        "description": "Enable or disable battery boost. When active, the maximum available home battery power is added until the home battery is drained to configured SoC limit. Note: boost will not work while the battery is on hold (e.g. during fast charging or planned charging with discharge prevention enabled).",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/battery#battery-boost"
-        },
-        "operationId": "setLoadpointBatteryBoost",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/enable"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/BooleanResult"
-          }
-        },
-        "summary": "Set battery boost",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/batteryboostlimit/{soc}": {
-      "post": {
-        "description": "Set the SoC limit for battery boost. Home battery will be used to support charging up to this SoC level. A value of 100 (default) disabled the boost feature in UI and API.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/battery#battery-boost"
-        },
-        "operationId": "setLoadpointBatteryBoostLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/IntegerResult"
-          }
-        },
-        "summary": "Set battery boost SoC limit",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/disable/delay/{delay}": {
-      "post": {
-        "description": "Delay before charging stops in solar mode.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints"
-        },
-        "operationId": "setLoadpointDisableDelay",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/delay"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NanoSecondsResult"
-          }
-        },
-        "summary": "Disable threshold-delay",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/disable/threshold/{threshold}": {
-      "post": {
-        "description": "Specifies the grid draw power to stop charging in solar mode.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#threshold-1"
-        },
-        "operationId": "setLoadpointDisableThreshold",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/threshold"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Disable threshold",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/enable/delay/{delay}": {
-      "post": {
-        "description": "Delay before charging starts in solar mode.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#delay"
-        },
-        "operationId": "setLoadpointEnableDelay",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/delay"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NanoSecondsResult"
-          }
-        },
-        "summary": "Enable threshold-delay",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/enable/threshold/{threshold}": {
-      "post": {
-        "description": "Specifies the available surplus power to start charging in solar mode.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#threshold"
-        },
-        "operationId": "setLoadpointEnableThreshold",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/threshold"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Enable threshold",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/limitenergy/{energy}": {
-      "post": {
-        "description": "Updates the energy limit of the loadpoint. Only available for guest vehicles and vehicles with unknown SoC. Limit is removed on vehicle disconnect.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/limits"
-        },
-        "operationId": "setLoadpointEnergyLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/energy"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Update energy limit",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/limitsoc/{soc}": {
-      "post": {
-        "description": "Sets the session SoC limit. Cleared on disconnect. Takes precedence over the vehicle's configured limit while set; once cleared (set to 0), the vehicle limit applies again.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/limits"
-        },
-        "operationId": "setLoadpointSocLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Update session SoC limit",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/maxcurrent/{current}": {
-      "post": {
-        "description": "Updates the maximum current of the loadpoint.",
-        "operationId": "setLoadpointMaxCurrent",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/current"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Update maximum current",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/mincurrent/{current}": {
-      "post": {
-        "description": "Updates the minimum current of the loadpoint.",
-        "operationId": "setLoadpointMinCurrent",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/current"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Update minimum current",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/mintemp/{temp}": {
-      "post": {
-        "description": "Sets the minimum temperature for heating devices. The device is heated as fast as possible while below this value. Set to 0 to disable.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/limits"
-        },
-        "operationId": "setLoadpointMinTemp",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/temp"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Update minimum temperature",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/mode/{mode}": {
-      "post": {
-        "description": "Changes the charging behavior of the loadpoint.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/solar-charging"
-        },
-        "operationId": "setLoadpointMode",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/mode"
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/Mode"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Update charge mode",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/phases/{phases}": {
-      "post": {
-        "description": "Updates the allowed phases of the loadpoint. Selects the desired phase mode for chargers with automatic phase switching. For manual phase switching chargers (via cable or Lasttrennschalter) this value tells evcc the actual phases.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#phases"
-        },
-        "operationId": "setLoadpointPhases",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/phases"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          },
-          "400": {
-            "description": "Invalid phases-value. You have most likely entered the value 0 for a wallbox that cannot switch phases automatically."
-          }
-        },
-        "summary": "Update allowed phases",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/plan": {
-      "get": {
-        "description": "Returns the current charging plan for this loadpoint.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "getLoadpointPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "allOf": [
-                    {
-                      "properties": {
-                        "planId": {
-                          "$ref": "#/components/schemas/Id"
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "$ref": "#/components/schemas/PlanRates"
-                    }
-                  ]
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Get charging plan",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/plan/energy": {
-      "delete": {
-        "description": "Delete charging plan. Only available when a vehicle without SoC is connected.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "deleteLoadpointEnergyPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/EmptyResult"
-          }
-        },
-        "summary": "Delete energy-based charging plan",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/plan/energy/{energy}/{timestamp}": {
-      "post": {
-        "description": "Create charging plan with fixed time and energy target. Only available when a vehicle without SoC is connected.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "setLoadpointEnergyPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/energy"
-          },
-          {
-            "$ref": "#/components/parameters/timestamp"
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/StaticEnergyPlan"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Set energy-based charging plan",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/plan/repeating/preview/{soc}/{weekdays}/{hourMinuteTime}/{timezone}": {
-      "get": {
-        "description": "Simulate repeating charging plan and return the result. Does not alter the actual charging plan.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "previewLoadpointRepeatingPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/soc"
-          },
-          {
-            "$ref": "#/components/parameters/weekdays"
-          },
-          {
-            "$ref": "#/components/parameters/hourMinuteTime"
-          },
-          {
-            "$ref": "#/components/parameters/timezone"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/PlanRatesResult"
-          }
-        },
-        "summary": "Repeating plan preview",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/plan/static/preview/energy/{energy}/{timestamp}": {
-      "get": {
-        "description": "Simulate charging plan based on energy goal. Does not alter the actual charging plan.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "previewLoadpointEnergyPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/energy"
-          },
-          {
-            "$ref": "#/components/parameters/timestamp"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/PlanRatesResult"
-          }
-        },
-        "summary": "Simulate energy-based charging plan",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/plan/static/preview/soc/{soc}/{timestamp}": {
-      "get": {
-        "description": "Simulate charging plan based on SoC goal. Does not alter the actual charging plan.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "previewLoadpointSocPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/soc"
-          },
-          {
-            "$ref": "#/components/parameters/timestamp"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/PlanRatesResult"
-          }
-        },
-        "summary": "Simulate soc-based charging plan",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/plan/strategy": {
-      "post": {
-        "description": "Updates the charging plan strategy for the loadpoint.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "setLoadpointPlanStrategy",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/PlanStrategy"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PlanStrategy"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Set plan strategy",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/priority/{priority}": {
-      "post": {
-        "description": "Set loadpoint priority.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#priority"
-        },
-        "operationId": "setLoadpointPriority",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "description": "Higher number means higher priority.",
-            "example": 2,
-            "in": "path",
-            "name": "priority",
-            "required": true,
-            "schema": {
-              "minimum": 0,
-              "type": "integer"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/IntegerResult"
-          }
-        },
-        "summary": "Set priority",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/smartcostlimit": {
-      "delete": {
-        "description": "Delete cost or emission limit for fast-charging with grid energy.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/dynamic-prices"
-        },
-        "operationId": "deleteLoadpointSmartCostLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
-          }
-        },
-        "summary": "Delete smart charging cost limit",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/smartcostlimit/{cost}": {
-      "post": {
-        "description": "Set cost or emission limit for fast-charging with grid energy.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/dynamic-prices"
-        },
-        "operationId": "setLoadpointSmartCostLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/costLimit"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Set smart charging cost limit",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/smartfeedinprioritylimit": {
-      "delete": {
-        "description": "Delete limit for feed-in priority optimization.",
-        "operationId": "deleteLoadpointSmartFeedInPriorityLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
-          }
-        },
-        "summary": "Delete smart feed-in priority limit",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/smartfeedinprioritylimit/{cost}": {
-      "post": {
-        "description": "Set limit for feed-in priority optimization.",
-        "operationId": "setLoadpointSmartFeedInPriorityLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/costLimit"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Set smart feed-in priority limit",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/vehicle": {
-      "delete": {
-        "description": "Remove vehicle from loadpoint. Connected vehicle is treated as guest vehicle.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/vehicle"
-        },
-        "operationId": "removeLoadpointVehicle",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/EmptyResult"
-          }
-        },
-        "summary": "Remove vehicle",
-        "tags": [
-          "loadpoints"
-        ]
-      },
-      "patch": {
-        "description": "Starts the automatic vehicle detection process.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/vehicle"
-        },
-        "operationId": "startLoadpointVehicleDetection",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/EmptyResult"
-          }
-        },
-        "summary": "Start vehicle detection",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/loadpoints/{id}/vehicle/{name}": {
-      "post": {
-        "description": "Assigns vehicle to loadpoint.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/vehicle"
-        },
-        "operationId": "assignLoadpointVehicle",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          },
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "vehicle": {
-                      "$ref": "#/components/schemas/VehicleTitle"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Assign vehicle",
-        "tags": [
-          "loadpoints"
-        ]
-      }
-    },
-    "/prioritysoc/{soc}": {
-      "post": {
-        "description": "Set battery priority SoC.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/battery"
-        },
-        "operationId": "setPrioritySoc",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Set battery priority SoC",
-        "tags": [
-          "battery"
-        ]
-      }
-    },
-    "/residualpower/{power}": {
-      "post": {
-        "description": "Set grid connection operating point.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/site#residualpower"
-        },
-        "operationId": "setResidualPower",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/power"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Set grid residual power",
-        "tags": [
-          "battery"
-        ]
-      }
-    },
-    "/session/{id}": {
-      "delete": {
-        "description": "Delete charging session.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/sessions"
-        },
-        "operationId": "deleteSession",
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
-          }
-        },
-        "summary": "Delete charging session",
-        "tags": [
-          "sessions"
-        ]
-      },
-      "parameters": [
-        {
-          "$ref": "#/components/parameters/id"
-        }
-      ],
-      "put": {
-        "description": "Update vehicle, loadpoint or odometer of a charging session. Only provided fields are changed; a null odometer clears the stored value.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/sessions"
-        },
-        "operationId": "updateSession",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "properties": {
-                  "loadpoint": {
-                    "$ref": "#/components/schemas/LoadpointName"
-                  },
-                  "odometer": {
-                    "$ref": "#/components/schemas/Odometer"
-                  },
-                  "vehicle": {
-                    "$ref": "#/components/schemas/VehicleName"
-                  }
-                },
-                "type": "object"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "description": "Success"
-          }
-        },
-        "summary": "Update charging session",
-        "tags": [
-          "sessions"
-        ]
-      }
-    },
-    "/sessions": {
-      "get": {
-        "description": "Returns a list of charging sessions.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/sessions"
-        },
-        "operationId": "getSessions",
-        "parameters": [
-          {
-            "description": "Response format (default json)",
-            "in": "query",
-            "name": "format",
-            "schema": {
-              "enum": [
-                "csv"
-              ],
-              "type": "string"
-            }
-          },
-          {
-            "description": "Language (defaults to accept header)",
-            "in": "query",
-            "name": "lang",
-            "schema": {
-              "example": "de",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Month filter",
-            "in": "query",
-            "name": "month",
-            "schema": {
-              "example": 2,
-              "maximum": 12,
-              "minimum": 1,
-              "type": "integer"
-            }
-          },
-          {
-            "description": "Year filter",
-            "in": "query",
-            "name": "year",
-            "schema": {
-              "example": 2025,
-              "type": "integer"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ChargingSessions"
-                }
-              },
-              "text/csv": {
-                "schema": {
-                  "description": "Download csv-file",
-                  "format": "binary",
-                  "type": "string"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Charging sessions",
-        "tags": [
-          "sessions"
-        ]
-      }
-    },
-    "/settings/telemetry/{enable}": {
-      "post": {
-        "description": "Enable or disable telemetry. Note: Telemetry requires sponsorship.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/telemetry"
-        },
-        "operationId": "setTelemetryStatus",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/enable"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/BooleanResult"
-          },
-          "400": {
-            "description": "Sponsorship required"
-          }
-        },
-        "summary": "Enable/disable telemetry",
-        "tags": [
-          "system"
-        ]
-      }
-    },
-    "/smartcostlimit": {
-      "delete": {
-        "description": "Convenience method to remove limit for all loadpoints at once. Value is applied to each individual loadpoint.",
-        "operationId": "removeGlobalSmartCostLimit",
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
-          }
-        },
-        "summary": "Remove smart charging cost limit for all loadpoints.",
-        "tags": [
-          "general"
-        ]
-      }
-    },
-    "/smartcostlimit/{cost}": {
-      "post": {
-        "description": "Convenience method to set smart charging cost limit for all loadpoints at once. Value is applied to each individual loadpoint.",
-        "operationId": "setGlobalSmartCostLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/costLimit"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Set smart charging cost limit for all loadpoints",
-        "tags": [
-          "general"
-        ]
-      }
-    },
-    "/smartfeedinprioritylimit": {
-      "delete": {
-        "description": "Convenience method to remove limit for all loadpoints at once. Value is applied to each individual loadpoint.",
-        "operationId": "removeGlobalSmartFeedInPriorityLimit",
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
-          }
-        },
-        "summary": "Remove smart feed-in priority limit for all loadpoints.",
-        "tags": [
-          "general"
-        ]
-      }
-    },
-    "/smartfeedinprioritylimit/{cost}": {
-      "post": {
-        "description": "Convenience method to set smart feed-in priority limit for all loadpoints at once. Value is applied to each individual loadpoint.",
-        "operationId": "setGlobalSmartFeedInPriorityLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/costLimit"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
-          }
-        },
-        "summary": "Set smart feed-in priority limit for all loadpoints",
-        "tags": [
-          "general"
-        ]
-      }
-    },
-    "/solaradjusted/{enable}": {
-      "post": {
-        "description": "Adjust the solar forecast to real production data of the current day.",
-        "operationId": "setSolarAdjusted",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/enable"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/BooleanResult"
-          }
-        },
-        "summary": "Adjust solar forecast",
-        "tags": [
-          "experimental"
-        ]
-      }
-    },
-    "/state": {
-      "get": {
-        "description": "Returns the complete state of the system. This structure is used by the UI. It can be filtered by JQ to only return a subset of the data.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/integrations/rest-api"
-        },
-        "operationId": "getState",
-        "parameters": [
-          {
-            "description": "Filter the state with JQ",
-            "examples": {
-              "all": {
-                "summary": "complete state",
-                "value": "."
-              },
-              "firstLoadpoint": {
-                "summary": "only first loadpoint",
-                "value": ".loadpoints[0]"
-              }
-            },
-            "in": "query",
-            "name": "jq",
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/State"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "System state",
-        "tags": [
-          "general"
-        ]
-      }
-    },
-    "/system/cache": {
-      "delete": {
-        "description": "Clears all cached data. This resets all cached values from tariffs, vehicle APIs, and other components that use caching.",
-        "operationId": "clearCache",
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/SuccessResult"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "Clear cache",
-        "tags": [
-          "system"
-        ]
-      }
-    },
-    "/system/log": {
-      "get": {
-        "description": "Returns the latest log lines.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/reference/configuration/log"
-        },
-        "operationId": "getSystemLogs",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/logAreas"
-          },
-          {
-            "$ref": "#/components/parameters/logLevel"
-          },
-          {
-            "description": "Number of log lines to return",
-            "example": 100,
-            "in": "query",
-            "name": "count",
-            "schema": {
-              "type": "integer"
-            }
-          },
-          {
-            "description": "File type",
-            "in": "query",
-            "name": "format",
-            "schema": {
-              "enum": [
-                "txt"
-              ],
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                }
-              },
-              "text/plain": {
-                "schema": {
-                  "description": "Download txt-file",
-                  "format": "binary",
-                  "type": "string"
-                }
-              }
-            },
-            "description": "Success"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "Logs",
-        "tags": [
-          "system"
-        ]
-      }
-    },
-    "/system/log/areas": {
-      "get": {
-        "description": "Returns a list of all log areas (e.g. `lp-1`, `site`, `db`).",
-        "operationId": "getLogAreas",
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/LogAreas"
-                }
-              }
-            },
-            "description": "Success"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "List of all log areas",
-        "tags": [
-          "system"
-        ]
-      }
-    },
-    "/system/shutdown": {
-      "post": {
-        "description": "Shut down instance. There is no reboot command. We expect the underlying system (docker, systemd, etc.) to restart the evcc instance once it's terminated.",
-        "operationId": "shutdownSystem",
-        "responses": {
-          "204": {
-            "$ref": "#/components/responses/BlankResponse"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "Shutdown evcc",
-        "tags": [
-          "system"
-        ]
-      }
-    },
-    "/tariff/{type}": {
-      "get": {
-        "description": "Returns the prices or emission values for the upcoming hours",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/tariffs"
-        },
-        "operationId": "getTariffInfo",
-        "parameters": [
-          {
-            "description": "Tariff type",
-            "in": "path",
-            "name": "type",
-            "required": true,
-            "schema": {
-              "enum": [
-                "grid",
-                "feedin",
-                "co2",
-                "planner",
-                "solar"
-              ],
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "rates": {
-                      "$ref": "#/components/schemas/Rates"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
-          },
-          "404": {
-            "description": "Tariff not defined"
-          }
-        },
-        "summary": "Tariff information",
-        "tags": [
-          "tariffs"
-        ]
-      }
-    },
-    "/vehicles/{name}/limitsoc/{soc}": {
-      "post": {
-        "description": "Charging will stop when this SoC is reached.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/limits"
-        },
-        "operationId": "setVehicleSocLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          },
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/SocResult"
-          }
-        },
-        "summary": "Set SoC limit",
-        "tags": [
-          "vehicles"
-        ]
-      }
-    },
-    "/vehicles/{name}/minsoc/{soc}": {
-      "post": {
-        "description": "Vehicle will be fast-charged until this SoC is reached.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/limits"
-        },
-        "operationId": "setVehicleMinSoc",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          },
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/SocResult"
-          }
-        },
-        "summary": "Set minimum SoC",
-        "tags": [
-          "vehicles"
-        ]
-      }
-    },
-    "/vehicles/{name}/mode": {
-      "delete": {
-        "description": "Resets the vehicle charge mode to keep the last selected mode.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/solar-charging"
-        },
-        "operationId": "deleteVehicleMode",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
-          }
-        },
-        "summary": "Reset charge mode",
-        "tags": [
-          "vehicles"
-        ]
-      }
-    },
-    "/vehicles/{name}/mode/{mode}": {
-      "post": {
-        "description": "Sets the charge mode applied when this vehicle becomes active on a loadpoint.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/solar-charging"
-        },
-        "operationId": "setVehicleMode",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          },
-          {
-            "$ref": "#/components/parameters/mode"
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "mode": {
-                      "$ref": "#/components/schemas/Mode"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Set charge mode",
-        "tags": [
-          "vehicles"
-        ]
-      }
-    },
-    "/vehicles/{name}/plan/repeating": {
-      "post": {
-        "description": "Updates the repeating charging plan.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "updateVehicleRepeatingPlans",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "items": {
-                  "$ref": "#/components/schemas/RepeatingPlan"
-                },
-                "type": "array"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "items": {
-                    "$ref": "#/components/schemas/RepeatingPlan"
-                  },
-                  "type": "array"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Update repeating plans",
-        "tags": [
-          "vehicles"
-        ]
-      }
-    },
-    "/vehicles/{name}/plan/soc": {
-      "delete": {
-        "description": "Delete the charging plan",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "deleteVehicleSocPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/EmptyResult"
-          }
-        },
-        "summary": "Delete a SoC-based charging plan",
-        "tags": [
-          "vehicles"
-        ]
-      }
-    },
-    "/vehicles/{name}/plan/soc/{soc}/{timestamp}": {
-      "post": {
-        "description": "Create charging plan with fixed time and SoC target.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "setVehicleSocPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          },
-          {
-            "$ref": "#/components/parameters/soc"
-          },
-          {
-            "$ref": "#/components/parameters/timestamp"
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "soc": {
-                      "$ref": "#/components/schemas/Soc"
-                    },
-                    "time": {
-                      "$ref": "#/components/schemas/Timestamp"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Set a SoC-based charging plan",
-        "tags": [
-          "vehicles"
-        ]
-      }
-    },
-    "/vehicles/{name}/plan/strategy": {
-      "post": {
-        "description": "Updates the charging plan strategy for the vehicle.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/features/plans"
-        },
-        "operationId": "setVehiclePlanStrategy",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/PlanStrategy"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PlanStrategy"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "Set plan strategy",
-        "tags": [
-          "vehicles"
-        ]
-      }
     }
   },
   "tags": [
+    {
+      "name": "state"
+    },
     {
       "name": "auth"
     },
@@ -3071,5 +42,5403 @@
     {
       "name": "vehicles"
     }
-  ]
-}
\ No newline at end of file
+  ],
+  "paths": {
+    "/auth/login": {
+      "post": {
+        "operationId": "login",
+        "summary": "Login",
+        "description": "Administrator login. Returns authorization cookie required for all protected endpoints.",
+        "tags": [
+          "auth"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "password": {
+                    "$ref": "#/components/schemas/Password"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Success",
+            "headers": {
+              "Set-Cookie": {
+                "description": "The authorization cookie",
+                "schema": {
+                  "type": "string",
+                  "example": "auth=ey...qY; Path=/; Expires=Fri, 04 Apr 2025 14:35:37 GMT; HttpOnly; SameSite=Strict"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Invalid password provided"
+          }
+        }
+      }
+    },
+    "/auth/logout": {
+      "post": {
+        "operationId": "logout",
+        "summary": "Logout",
+        "description": "Logout and delete authorization cookie",
+        "tags": [
+          "auth"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "headers": {
+              "Set-Cookie": {
+                "description": "The authorization cookie",
+                "schema": {
+                  "type": "string",
+                  "enum": [
+                    "auth=; Path=/; HttpOnly"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/auth/password": {
+      "put": {
+        "operationId": "changePassword",
+        "summary": "Change admin password",
+        "description": "Changes the admin password.",
+        "tags": [
+          "auth"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ChangePassword"
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Success"
+          },
+          "400": {
+            "description": "Invalid password provided"
+          }
+        }
+      }
+    },
+    "/auth/status": {
+      "get": {
+        "operationId": "getAuthStatus",
+        "summary": "Authentication status",
+        "description": "Whether the current user is logged in.",
+        "tags": [
+          "auth"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string",
+                  "enum": [
+                    "true",
+                    "false"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/auth/apikey": {
+      "get": {
+        "operationId": "getApiKeyStatus",
+        "summary": "API key status",
+        "description": "Reports whether an API key has been generated. The key itself is\nonly returned once at creation time (POST), never on subsequent\nreads.\n",
+        "tags": [
+          "auth"
+        ],
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "configured": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      },
+      "post": {
+        "operationId": "regenerateApiKey",
+        "summary": "Generate or rotate the API key",
+        "description": "Generates a fresh API key, replacing any existing one. The\nreturned key is shown only once; store it immediately.\n\nEven when the request is authenticated via API key (Bearer), the\nadmin password must be supplied in the request body to prevent a\nleaked key from rotating itself. The password check is skipped\nwhen the server is started with `--disable-auth`.\n",
+        "tags": [
+          "auth"
+        ],
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "password": {
+                    "$ref": "#/components/schemas/Password"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "key": {
+                      "type": "string",
+                      "description": "The new API key (cleartext, shown once).",
+                      "example": "evcc_aB3xYz7k0Pq2sN5mWtR4"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Invalid admin password"
+          },
+          "403": {
+            "description": "Forbidden in demo mode"
+          }
+        }
+      }
+    },
+    "/batterydischargecontrol/{enable}": {
+      "post": {
+        "operationId": "setBatteryDischargeControl",
+        "summary": "Control battery-discharge",
+        "description": "Prevent home battery discharge during vehicle fast charging.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/battery"
+        },
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/enable"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/BooleanResult"
+          }
+        }
+      }
+    },
+    "/batterygridchargelimit": {
+      "delete": {
+        "operationId": "removeBatteryGridChargeLimit",
+        "summary": "Remove battery grid charge limit",
+        "description": "Remove battery grid charge limit.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/battery"
+        },
+        "tags": [
+          "battery"
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NullResult"
+          }
+        }
+      }
+    },
+    "/batterygridchargelimit/{cost}": {
+      "post": {
+        "operationId": "setBatteryGridChargeLimit",
+        "summary": "Set battery grid charge limit",
+        "description": "Charge home battery from grid when price or emissions are below the threshold. Uses price if a dynamic tariff exists. Uses emissions if a CO₂-tariff is configured. Ignored otherwise.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/battery"
+        },
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/costLimit"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/batterymode": {
+      "delete": {
+        "operationId": "disableExternalBatteryControl",
+        "summary": "Disable external battery control",
+        "description": "Default evcc control behavior is restored",
+        "tags": [
+          "battery"
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/BatteryModeResult"
+          }
+        }
+      }
+    },
+    "/batterymode/{batteryMode}": {
+      "post": {
+        "operationId": "setExternalBatteryMode",
+        "summary": "Set external battery mode",
+        "description": "Directly controls the mode of all controllable batteries. evcc behavior like 'price limit' or 'prevent discharge while fast charging' is overruled. External mode resets after 60s. The external system has to call this endpoint regularly.",
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/batteryMode"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/BatteryModeResult"
+          }
+        }
+      }
+    },
+    "/buffersoc/{soc}": {
+      "post": {
+        "operationId": "setBufferSoc",
+        "summary": "Set battery buffer SoC",
+        "description": "Set battery buffer SoC.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/battery"
+        },
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/soc"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/bufferstartsoc/{soc}": {
+      "post": {
+        "operationId": "setBufferStartSoc",
+        "summary": "Set battery buffer start SoC",
+        "description": "Set battery buffer start SoC.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/battery"
+        },
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/soc"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/batteryboost/{enable}": {
+      "post": {
+        "operationId": "setLoadpointBatteryBoost",
+        "summary": "Set battery boost",
+        "description": "Enable or disable battery boost. When active, the maximum available home battery power is added until the home battery is drained to configured SoC limit. Note: boost will not work while the battery is on hold (e.g. during fast charging or planned charging with discharge prevention enabled).",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/battery#battery-boost"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/enable"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/BooleanResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/batteryboostlimit/{soc}": {
+      "post": {
+        "operationId": "setLoadpointBatteryBoostLimit",
+        "summary": "Set battery boost SoC limit",
+        "description": "Set the SoC limit for battery boost. Home battery will be used to support charging up to this SoC level. A value of 100 (default) disabled the boost feature in UI and API.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/battery#battery-boost"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/soc"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/IntegerResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/disable/delay/{delay}": {
+      "post": {
+        "operationId": "setLoadpointDisableDelay",
+        "summary": "Disable threshold-delay",
+        "description": "Delay before charging stops in solar mode.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/delay"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NanoSecondsResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/disable/threshold/{threshold}": {
+      "post": {
+        "operationId": "setLoadpointDisableThreshold",
+        "summary": "Disable threshold",
+        "description": "Specifies the grid draw power to stop charging in solar mode.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#threshold-1"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/threshold"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/enable/delay/{delay}": {
+      "post": {
+        "operationId": "setLoadpointEnableDelay",
+        "summary": "Enable threshold-delay",
+        "description": "Delay before charging starts in solar mode.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#delay"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/delay"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NanoSecondsResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/enable/threshold/{threshold}": {
+      "post": {
+        "operationId": "setLoadpointEnableThreshold",
+        "summary": "Enable threshold",
+        "description": "Specifies the available surplus power to start charging in solar mode.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#threshold"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/threshold"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/limitenergy/{energy}": {
+      "post": {
+        "operationId": "setLoadpointEnergyLimit",
+        "summary": "Update energy limit",
+        "description": "Updates the energy limit of the loadpoint. Only available for guest vehicles and vehicles with unknown SoC. Limit is removed on vehicle disconnect.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/limits"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/energy"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/limitsoc/{soc}": {
+      "post": {
+        "operationId": "setLoadpointSocLimit",
+        "summary": "Update session SoC limit",
+        "description": "Sets the session SoC limit. Cleared on disconnect. Takes precedence over the vehicle's configured limit while set; once cleared (set to 0), the vehicle limit applies again.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/limits"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/soc"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/maxcurrent/{current}": {
+      "post": {
+        "operationId": "setLoadpointMaxCurrent",
+        "summary": "Update maximum current",
+        "description": "Updates the maximum current of the loadpoint.",
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/current"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/mincurrent/{current}": {
+      "post": {
+        "operationId": "setLoadpointMinCurrent",
+        "summary": "Update minimum current",
+        "description": "Updates the minimum current of the loadpoint.",
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/current"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/mintemp/{temp}": {
+      "post": {
+        "operationId": "setLoadpointMinTemp",
+        "summary": "Update minimum temperature",
+        "description": "Sets the minimum temperature for heating devices. The device is heated as fast as possible while below this value. Set to 0 to disable.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/limits"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/temp"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/mode/{mode}": {
+      "post": {
+        "operationId": "setLoadpointMode",
+        "summary": "Update charge mode",
+        "description": "Changes the charging behavior of the loadpoint.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/solar-charging"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/mode"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ChargeMode"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/phases/{phases}": {
+      "post": {
+        "operationId": "setLoadpointPhases",
+        "summary": "Update allowed phases",
+        "description": "Updates the allowed phases of the loadpoint. Selects the desired phase mode for chargers with automatic phase switching. For manual phase switching chargers (via cable or Lasttrennschalter) this value tells evcc the actual phases.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#phases"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/phases"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          },
+          "400": {
+            "description": "Invalid phases-value. You have most likely entered the value 0 for a wallbox that cannot switch phases automatically."
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/plan": {
+      "get": {
+        "operationId": "getLoadpointPlan",
+        "summary": "Get charging plan",
+        "description": "Returns the current charging plan for this loadpoint.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "planId": {
+                          "$ref": "#/components/schemas/Id"
+                        }
+                      }
+                    },
+                    {
+                      "$ref": "#/components/schemas/PlanRates"
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/plan/energy": {
+      "delete": {
+        "operationId": "deleteLoadpointEnergyPlan",
+        "summary": "Delete energy-based charging plan",
+        "description": "Delete charging plan. Only available when a vehicle without SoC is connected.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/EmptyResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/plan/energy/{energy}/{timestamp}": {
+      "post": {
+        "operationId": "setLoadpointEnergyPlan",
+        "summary": "Set energy-based charging plan",
+        "description": "Create charging plan with fixed time and energy target. Only available when a vehicle without SoC is connected.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/energy"
+          },
+          {
+            "$ref": "#/components/parameters/timestamp"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StaticEnergyPlan"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/plan/repeating/preview/{soc}/{weekdays}/{hourMinuteTime}/{timezone}": {
+      "get": {
+        "operationId": "previewLoadpointRepeatingPlan",
+        "summary": "Repeating plan preview",
+        "description": "Simulate repeating charging plan and return the result. Does not alter the actual charging plan.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/soc"
+          },
+          {
+            "$ref": "#/components/parameters/weekdays"
+          },
+          {
+            "$ref": "#/components/parameters/hourMinuteTime"
+          },
+          {
+            "$ref": "#/components/parameters/timezone"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/PlanRatesResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/plan/static/preview/soc/{soc}/{timestamp}": {
+      "get": {
+        "operationId": "previewLoadpointSocPlan",
+        "summary": "Simulate soc-based charging plan",
+        "description": "Simulate charging plan based on SoC goal. Does not alter the actual charging plan.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/soc"
+          },
+          {
+            "$ref": "#/components/parameters/timestamp"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/PlanRatesResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/plan/static/preview/energy/{energy}/{timestamp}": {
+      "get": {
+        "operationId": "previewLoadpointEnergyPlan",
+        "summary": "Simulate energy-based charging plan",
+        "description": "Simulate charging plan based on energy goal. Does not alter the actual charging plan.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/energy"
+          },
+          {
+            "$ref": "#/components/parameters/timestamp"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/PlanRatesResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/plan/strategy": {
+      "post": {
+        "operationId": "setLoadpointPlanStrategy",
+        "summary": "Set plan strategy",
+        "description": "Updates the charging plan strategy for the loadpoint.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PlanStrategy"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PlanStrategy"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/priority/{priority}": {
+      "post": {
+        "operationId": "setLoadpointPriority",
+        "summary": "Set priority",
+        "description": "Set loadpoint priority.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#priority"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "name": "priority",
+            "in": "path",
+            "description": "Higher number means higher priority.",
+            "required": true,
+            "example": 2,
+            "schema": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/IntegerResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/smartcostlimit": {
+      "delete": {
+        "operationId": "deleteLoadpointSmartCostLimit",
+        "summary": "Delete smart charging cost limit",
+        "description": "Delete cost or emission limit for fast-charging with grid energy.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/dynamic-prices"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NullResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/smartcostlimit/{cost}": {
+      "post": {
+        "operationId": "setLoadpointSmartCostLimit",
+        "summary": "Set smart charging cost limit",
+        "description": "Set cost or emission limit for fast-charging with grid energy.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/dynamic-prices"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/costLimit"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/smartfeedinprioritylimit": {
+      "delete": {
+        "operationId": "deleteLoadpointSmartFeedInPriorityLimit",
+        "summary": "Delete smart feed-in priority limit",
+        "description": "Delete limit for feed-in priority optimization.",
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NullResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/smartfeedinprioritylimit/{cost}": {
+      "post": {
+        "operationId": "setLoadpointSmartFeedInPriorityLimit",
+        "summary": "Set smart feed-in priority limit",
+        "description": "Set limit for feed-in priority optimization.",
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/costLimit"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/vehicle": {
+      "delete": {
+        "operationId": "removeLoadpointVehicle",
+        "summary": "Remove vehicle",
+        "description": "Remove vehicle from loadpoint. Connected vehicle is treated as guest vehicle.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/vehicle"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/EmptyResult"
+          }
+        }
+      },
+      "patch": {
+        "operationId": "startLoadpointVehicleDetection",
+        "summary": "Start vehicle detection",
+        "description": "Starts the automatic vehicle detection process.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/vehicle"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/EmptyResult"
+          }
+        }
+      }
+    },
+    "/loadpoints/{id}/vehicle/{name}": {
+      "post": {
+        "operationId": "assignLoadpointVehicle",
+        "summary": "Assign vehicle",
+        "description": "Assigns vehicle to loadpoint.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/vehicle"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          },
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "vehicle": {
+                      "$ref": "#/components/schemas/VehicleTitle"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/prioritysoc/{soc}": {
+      "post": {
+        "operationId": "setPrioritySoc",
+        "summary": "Set battery priority SoC",
+        "description": "Set battery priority SoC.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/battery"
+        },
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/soc"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/residualpower/{power}": {
+      "post": {
+        "operationId": "setResidualPower",
+        "summary": "Set grid residual power",
+        "description": "Set grid connection operating point.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/site#residualpower"
+        },
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/power"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/solaradjusted/{enable}": {
+      "post": {
+        "operationId": "setSolarAdjusted",
+        "summary": "Adjust solar forecast",
+        "description": "Adjust the solar forecast to real production data of the current day.",
+        "tags": [
+          "experimental"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/enable"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/BooleanResult"
+          }
+        }
+      }
+    },
+    "/smartfeedinprioritylimit": {
+      "delete": {
+        "operationId": "removeGlobalSmartFeedInPriorityLimit",
+        "summary": "Remove smart feed-in priority limit for all loadpoints.",
+        "description": "Convenience method to remove limit for all loadpoints at once. Value is applied to each individual loadpoint.",
+        "tags": [
+          "general"
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NullResult"
+          }
+        }
+      }
+    },
+    "/smartfeedinprioritylimit/{cost}": {
+      "post": {
+        "operationId": "setGlobalSmartFeedInPriorityLimit",
+        "summary": "Set smart feed-in priority limit for all loadpoints",
+        "description": "Convenience method to set smart feed-in priority limit for all loadpoints at once. Value is applied to each individual loadpoint.",
+        "tags": [
+          "general"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/costLimit"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/session/{id}": {
+      "parameters": [
+        {
+          "$ref": "#/components/parameters/id"
+        }
+      ],
+      "put": {
+        "operationId": "updateSession",
+        "summary": "Update charging session",
+        "description": "Update vehicle, loadpoint or odometer of a charging session. Only provided fields are changed; a null odometer clears the stored value.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/sessions"
+        },
+        "tags": [
+          "sessions"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "vehicle": {
+                    "$ref": "#/components/schemas/VehicleName"
+                  },
+                  "loadpoint": {
+                    "$ref": "#/components/schemas/LoadpointName"
+                  },
+                  "odometer": {
+                    "$ref": "#/components/schemas/Odometer"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Success"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "deleteSession",
+        "summary": "Delete charging session",
+        "description": "Delete charging session.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/sessions"
+        },
+        "tags": [
+          "sessions"
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NullResult"
+          }
+        }
+      }
+    },
+    "/gridsessions": {
+      "get": {
+        "operationId": "getGridSessions",
+        "summary": "Grid limitation sessions",
+        "description": "Returns a list of HEMS grid limitation events.",
+        "tags": [
+          "sessions"
+        ],
+        "parameters": [
+          {
+            "name": "format",
+            "in": "query",
+            "description": "Response format (default json)",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "csv"
+              ]
+            }
+          },
+          {
+            "name": "lang",
+            "in": "query",
+            "description": "Language (defaults to accept header)",
+            "schema": {
+              "type": "string",
+              "example": "de"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GridSessions"
+                }
+              },
+              "text/csv": {
+                "schema": {
+                  "description": "Download csv-file",
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/sessions": {
+      "get": {
+        "operationId": "getSessions",
+        "summary": "Charging sessions",
+        "description": "Returns a list of charging sessions.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/sessions"
+        },
+        "tags": [
+          "sessions"
+        ],
+        "parameters": [
+          {
+            "name": "format",
+            "in": "query",
+            "description": "Response format (default json)",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "csv"
+              ]
+            }
+          },
+          {
+            "name": "lang",
+            "in": "query",
+            "description": "Language (defaults to accept header)",
+            "schema": {
+              "type": "string",
+              "example": "de"
+            }
+          },
+          {
+            "name": "month",
+            "in": "query",
+            "description": "Month filter",
+            "schema": {
+              "type": "integer",
+              "example": 2,
+              "minimum": 1,
+              "maximum": 12
+            }
+          },
+          {
+            "name": "year",
+            "in": "query",
+            "description": "Year filter",
+            "schema": {
+              "type": "integer",
+              "example": 2025
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ChargingSessions"
+                }
+              },
+              "text/csv": {
+                "schema": {
+                  "description": "Download csv-file",
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/settings/telemetry/{enable}": {
+      "post": {
+        "operationId": "setTelemetryStatus",
+        "summary": "Enable/disable telemetry",
+        "description": "Enable or disable telemetry. Note: Telemetry requires sponsorship.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/telemetry"
+        },
+        "tags": [
+          "system"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/enable"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/BooleanResult"
+          },
+          "400": {
+            "description": "Sponsorship required"
+          }
+        }
+      }
+    },
+    "/smartcostlimit": {
+      "delete": {
+        "operationId": "removeGlobalSmartCostLimit",
+        "summary": "Remove smart charging cost limit for all loadpoints.",
+        "description": "Convenience method to remove limit for all loadpoints at once. Value is applied to each individual loadpoint.",
+        "tags": [
+          "general"
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NullResult"
+          }
+        }
+      }
+    },
+    "/smartcostlimit/{cost}": {
+      "post": {
+        "operationId": "setGlobalSmartCostLimit",
+        "summary": "Set smart charging cost limit for all loadpoints",
+        "description": "Convenience method to set smart charging cost limit for all loadpoints at once. Value is applied to each individual loadpoint.",
+        "tags": [
+          "general"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/costLimit"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/state": {
+      "get": {
+        "operationId": "state",
+        "summary": "System state",
+        "description": "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.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/integrations/rest-api"
+        },
+        "tags": [
+          "state"
+        ],
+        "parameters": [
+          {
+            "name": "jq",
+            "in": "query",
+            "description": "Filter the state with JQ",
+            "schema": {
+              "type": "string"
+            },
+            "examples": {
+              "all": {
+                "value": ".",
+                "summary": "complete state"
+              },
+              "firstLoadpoint": {
+                "value": ".loadpoints[0]",
+                "summary": "only first loadpoint"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/State"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/system/log": {
+      "get": {
+        "operationId": "getSystemLogs",
+        "summary": "Logs",
+        "description": "Returns the latest log lines.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/log"
+        },
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "tags": [
+          "system"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/logAreas"
+          },
+          {
+            "$ref": "#/components/parameters/logLevel"
+          },
+          {
+            "name": "count",
+            "in": "query",
+            "description": "Number of log lines to return",
+            "example": 100,
+            "schema": {
+              "type": "integer"
+            }
+          },
+          {
+            "name": "format",
+            "in": "query",
+            "description": "File type",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "txt"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "text/plain": {
+                "schema": {
+                  "description": "Download txt-file",
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      }
+    },
+    "/system/log/areas": {
+      "get": {
+        "operationId": "getLogAreas",
+        "summary": "List of all log areas",
+        "description": "Returns a list of all log areas (e.g. `lp-1`, `site`, `db`).",
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "tags": [
+          "system"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/LogAreas"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      }
+    },
+    "/system/cache": {
+      "delete": {
+        "operationId": "clearCache",
+        "summary": "Clear cache",
+        "description": "Clears all cached data. This resets all cached values from tariffs, vehicle APIs, and other components that use caching.",
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "tags": [
+          "system"
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/SuccessResult"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      }
+    },
+    "/system/shutdown": {
+      "post": {
+        "operationId": "shutdownSystem",
+        "summary": "Shutdown evcc",
+        "description": "Shut down instance. There is no reboot command. We expect the underlying system (docker, systemd, etc.) to restart the evcc instance once it's terminated.",
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "tags": [
+          "system"
+        ],
+        "responses": {
+          "204": {
+            "$ref": "#/components/responses/BlankResponse"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      }
+    },
+    "/tariff/{type}": {
+      "get": {
+        "operationId": "getTariffInfo",
+        "summary": "Tariff information",
+        "description": "Returns the prices or emission values for the upcoming hours",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/tariffs"
+        },
+        "tags": [
+          "tariffs"
+        ],
+        "parameters": [
+          {
+            "name": "type",
+            "in": "path",
+            "description": "Tariff type",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "grid",
+                "feedin",
+                "co2",
+                "planner",
+                "solar"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "rates": {
+                      "$ref": "#/components/schemas/Rates"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Tariff not defined"
+          }
+        }
+      }
+    },
+    "/vehicles/{name}/limitsoc/{soc}": {
+      "post": {
+        "operationId": "setVehicleSocLimit",
+        "summary": "Set SoC limit",
+        "description": "Charging will stop when this SoC is reached.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/limits"
+        },
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          },
+          {
+            "$ref": "#/components/parameters/soc"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/SocResult"
+          }
+        }
+      }
+    },
+    "/vehicles/{name}/minsoc/{soc}": {
+      "post": {
+        "operationId": "setVehicleMinSoc",
+        "summary": "Set minimum SoC",
+        "description": "Vehicle will be fast-charged until this SoC is reached.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/limits"
+        },
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          },
+          {
+            "$ref": "#/components/parameters/soc"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/SocResult"
+          }
+        }
+      }
+    },
+    "/vehicles/{name}/mode": {
+      "delete": {
+        "operationId": "deleteVehicleMode",
+        "summary": "Reset charge mode",
+        "description": "Resets the vehicle charge mode to keep the last selected mode.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/solar-charging"
+        },
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NullResult"
+          }
+        }
+      }
+    },
+    "/vehicles/{name}/mode/{mode}": {
+      "post": {
+        "operationId": "setVehicleMode",
+        "summary": "Set charge mode",
+        "description": "Sets the charge mode applied when this vehicle becomes active on a loadpoint.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/solar-charging"
+        },
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          },
+          {
+            "$ref": "#/components/parameters/mode"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "mode": {
+                      "$ref": "#/components/schemas/ChargeMode"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/vehicles/{name}/plan/repeating": {
+      "post": {
+        "operationId": "updateVehicleRepeatingPlans",
+        "summary": "Update repeating plans",
+        "description": "Updates the repeating charging plan.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/RepeatingPlan"
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/RepeatingPlan"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/vehicles/{name}/plan/soc": {
+      "delete": {
+        "operationId": "deleteVehicleSocPlan",
+        "summary": "Delete a SoC-based charging plan",
+        "description": "Delete the charging plan",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/EmptyResult"
+          }
+        }
+      }
+    },
+    "/vehicles/{name}/plan/soc/{soc}/{timestamp}": {
+      "post": {
+        "operationId": "setVehicleSocPlan",
+        "summary": "Set a SoC-based charging plan",
+        "description": "Create charging plan with fixed time and SoC target.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          },
+          {
+            "$ref": "#/components/parameters/soc"
+          },
+          {
+            "$ref": "#/components/parameters/timestamp"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "soc": {
+                      "$ref": "#/components/schemas/Soc"
+                    },
+                    "time": {
+                      "$ref": "#/components/schemas/Timestamp"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/vehicles/{name}/plan/strategy": {
+      "post": {
+        "operationId": "setVehiclePlanStrategy",
+        "summary": "Set plan strategy",
+        "description": "Updates the charging plan strategy for the vehicle.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/features/plans"
+        },
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PlanStrategy"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PlanStrategy"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/db/backup": {
+      "get": {
+        "operationId": "downloadBackup",
+        "summary": "Download database backup",
+        "description": "Downloads the SQLite database as a backup file. Session users must supply the admin password in the X-Admin-Password header. API key holders via Bearer token are exempt.",
+        "tags": [
+          "db"
+        ],
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/adminPassword"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "SQLite database file",
+            "content": {
+              "application/octet-stream": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      }
+    },
+    "/db/restore": {
+      "post": {
+        "operationId": "restoreBackup",
+        "summary": "Restore database backup",
+        "description": "Restores the database from a previously downloaded backup file. Session users must supply the admin password in the X-Admin-Password header. API key holders via Bearer token are exempt. The instance restarts after a successful restore.",
+        "tags": [
+          "db"
+        ],
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/adminPassword"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "multipart/form-data": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "file"
+                ],
+                "properties": {
+                  "file": {
+                    "type": "string",
+                    "format": "binary",
+                    "description": "SQLite database backup file"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "204": {
+            "description": "Restore successful, instance is restarting"
+          },
+          "400": {
+            "description": "Invalid file or missing fields"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      }
+    },
+    "/db/reset": {
+      "post": {
+        "operationId": "resetDatabase",
+        "summary": "Reset database",
+        "description": "Selectively deletes sessions and/or settings from the database. Session users must supply the admin password in the X-Admin-Password header. API key holders via Bearer token are exempt. The instance restarts after a successful reset.",
+        "tags": [
+          "db"
+        ],
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/adminPassword"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "sessions": {
+                    "type": "boolean",
+                    "description": "Delete all charging sessions"
+                  },
+                  "settings": {
+                    "type": "boolean",
+                    "description": "Delete all settings, configs, and meters"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "204": {
+            "description": "Reset successful, instance is restarting"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      }
+    },
+    "/history/energy": {
+      "get": {
+        "operationId": "getEnergyHistory",
+        "summary": "Energy history",
+        "description": "Returns aggregated energy history data. Aggregate granularity defaults to 15 minutes. Supports CSV export.",
+        "tags": [
+          "experimental"
+        ],
+        "parameters": [
+          {
+            "name": "from",
+            "in": "query",
+            "description": "Start time (RFC3339)",
+            "schema": {
+              "type": "string",
+              "format": "date-time",
+              "example": "2026-07-01T00:00:00Z"
+            }
+          },
+          {
+            "name": "to",
+            "in": "query",
+            "description": "End time (RFC3339)",
+            "schema": {
+              "type": "string",
+              "format": "date-time",
+              "example": "2026-07-02T00:00:00Z"
+            }
+          },
+          {
+            "name": "aggregate",
+            "in": "query",
+            "description": "Aggregation interval. Examples: 15m, 1h, day, month",
+            "schema": {
+              "type": "string",
+              "default": "15m",
+              "example": "1h"
+            }
+          },
+          {
+            "name": "grouped",
+            "in": "query",
+            "description": "Group results by loadpoint",
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "example": false
+            }
+          },
+          {
+            "name": "group",
+            "in": "query",
+            "description": "Filter by entity group",
+            "schema": {
+              "type": "string",
+              "example": "battery",
+              "enum": [
+                "forecast",
+                "battery",
+                "grid",
+                "pv",
+                "home",
+                "loadpoint",
+                "meter",
+                "consumer"
+              ]
+            }
+          },
+          {
+            "name": "name",
+            "in": "query",
+            "description": "Filter by entity name",
+            "schema": {
+              "type": "string",
+              "example": "db:8"
+            }
+          },
+          {
+            "name": "title",
+            "in": "query",
+            "description": "Filter by entity title",
+            "schema": {
+              "type": "string",
+              "example": "Battery"
+            }
+          },
+          {
+            "name": "format",
+            "in": "query",
+            "description": "Response format",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "json",
+                "csv"
+              ],
+              "default": "json",
+              "example": "json"
+            }
+          },
+          {
+            "name": "lang",
+            "in": "query",
+            "description": "Language for CSV column headers (BCP 47, e.g. de, en). Defaults to Accept-Language header.",
+            "schema": {
+              "type": "string",
+              "example": "de"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Energy history data",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              },
+              "text/csv": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid parameters or database offline"
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "ChangePassword": {
+        "type": "object",
+        "properties": {
+          "current": {
+            "$ref": "#/components/schemas/Password"
+          },
+          "new": {
+            "$ref": "#/components/schemas/Password"
+          }
+        }
+      },
+      "ChargingSessions": {
+        "description": "Charging sessions",
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "$ref": "#/components/schemas/Id"
+            },
+            "created": {
+              "$ref": "#/components/schemas/Timestamp"
+            },
+            "finished": {
+              "$ref": "#/components/schemas/Timestamp"
+            },
+            "loadpoint": {
+              "$ref": "#/components/schemas/LoadpointName"
+            },
+            "vehicle": {
+              "$ref": "#/components/schemas/VehicleName"
+            },
+            "odometer": {
+              "$ref": "#/components/schemas/Odometer"
+            },
+            "meterStart": {
+              "nullable": true,
+              "type": "number",
+              "description": "Meter reading at start of charging session"
+            },
+            "meterStop": {
+              "nullable": true,
+              "type": "number",
+              "description": "Meter reading at end of charging session"
+            },
+            "chargedEnergy": {
+              "type": "number",
+              "description": "Charged energy in kWh"
+            }
+          }
+        }
+      },
+      "GridSessions": {
+        "description": "Grid limitation sessions",
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "$ref": "#/components/schemas/Id"
+            },
+            "created": {
+              "$ref": "#/components/schemas/Timestamp"
+            },
+            "finished": {
+              "$ref": "#/components/schemas/Timestamp"
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "consumption",
+                "feedin"
+              ],
+              "description": "Type of grid limitation event"
+            },
+            "gridPower": {
+              "type": "number",
+              "description": "Grid power in watts"
+            },
+            "limitPower": {
+              "type": "number",
+              "description": "Limitation power in watts"
+            },
+            "chargeDuration": {
+              "type": "number",
+              "description": "Duration of active charging"
+            },
+            "solarPercentage": {
+              "type": "number",
+              "description": "Solar percentage of the session"
+            },
+            "price": {
+              "type": "number",
+              "description": "Total price of the session"
+            },
+            "pricePerKWh": {
+              "type": "number",
+              "description": "Average price per kWh"
+            },
+            "co2PerKWh": {
+              "type": "number",
+              "description": "Average CO₂ emissions per kWh"
+            }
+          }
+        }
+      },
+      "Current": {
+        "description": "Electric current in A",
+        "type": "number",
+        "example": 16,
+        "minimum": 0
+      },
+      "Energy": {
+        "description": "Energy in kWh",
+        "type": "number",
+        "example": 25.5,
+        "minimum": 0
+      },
+      "Delay": {
+        "description": "Duration in seconds.",
+        "type": "integer",
+        "example": 60
+      },
+      "HourMinuteTime": {
+        "description": "Time in `HH:MM` format",
+        "type": "string",
+        "pattern": "[0-1][0-9]:[0-5][0-9]",
+        "format": "HH:MM",
+        "example": "12:30"
+      },
+      "IANATimeZone": {
+        "description": "Timezone in IANA format",
+        "externalDocs": {
+          "url": "https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List"
+        },
+        "type": "string",
+        "example": "Europe/Berlin"
+      },
+      "Id": {
+        "description": "Loadpoint index starting at 1.",
+        "type": "integer",
+        "example": 1,
+        "minimum": 1
+      },
+      "LoadpointName": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/loadpoints#title"
+        },
+        "type": "string",
+        "example": "Garage"
+      },
+      "LogArea": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/log#levels"
+        },
+        "type": "string"
+      },
+      "LogAreas": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/log#levels"
+        },
+        "type": "array",
+        "example": [
+          "lp-1",
+          "site",
+          "db"
+        ],
+        "items": {
+          "$ref": "#/components/schemas/LogArea"
+        }
+      },
+      "LogLevel": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/log#log"
+        },
+        "type": "string",
+        "example": "DEBUG",
+        "enum": [
+          "FATAL",
+          "ERROR",
+          "WARN",
+          "INFO",
+          "DEBUG",
+          "TRACE"
+        ]
+      },
+      "Odometer": {
+        "nullable": true,
+        "type": "number",
+        "description": "Vehicle odometer reading in kilometers"
+      },
+      "Password": {
+        "description": "Admin password",
+        "type": "string"
+      },
+      "Phases": {
+        "description": "Number of phases. (0: auto, 1: 1-phase, 3: 3-phase)",
+        "type": "string",
+        "example": "3",
+        "enum": [
+          "0",
+          "1",
+          "3"
+        ]
+      },
+      "PlanRates": {
+        "type": "object",
+        "properties": {
+          "duration": {
+            "description": "Duration in s",
+            "type": "integer",
+            "minimum": 0
+          },
+          "plan": {
+            "$ref": "#/components/schemas/Rates"
+          },
+          "planTime": {
+            "$ref": "#/components/schemas/Timestamp"
+          },
+          "power": {
+            "$ref": "#/components/schemas/Power"
+          }
+        }
+      },
+      "Power": {
+        "description": "Power in W",
+        "type": "number",
+        "minimum": 0,
+        "example": 2500
+      },
+      "Precondition": {
+        "description": "Late charging duration in seconds.",
+        "type": "integer",
+        "example": 3600,
+        "minimum": 0
+      },
+      "Rates": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/Rate"
+        }
+      },
+      "Soc": {
+        "description": "SOC in %",
+        "type": "number",
+        "example": 60,
+        "minimum": 0,
+        "maximum": 100
+      },
+      "Temp": {
+        "description": "Temperature in °C",
+        "type": "number",
+        "example": 50,
+        "minimum": 0
+      },
+      "Timestamp": {
+        "description": "Timestamp in RFC3339 format",
+        "type": "string",
+        "format": "date-time"
+      },
+      "VehicleName": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/vehicles#name"
+        },
+        "type": "string",
+        "minLength": 1,
+        "pattern": "[a-zA-Z0-9_.:-]+",
+        "example": "vehicle_1"
+      },
+      "VehicleTitle": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/reference/configuration/vehicles#title"
+        },
+        "type": "string",
+        "example": "blauer e-Golf"
+      },
+      "Weekdays": {
+        "description": "The Weekdays",
+        "type": "array",
+        "uniqueItems": true,
+        "example": [
+          1,
+          3,
+          4
+        ],
+        "items": {
+          "description": "0: Sunday, 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 6
+        }
+      },
+      "BatteryMode": {
+        "description": "Battery operation mode.",
+        "type": "string",
+        "enum": [
+          "unknown",
+          "normal",
+          "hold",
+          "charge",
+          "holdcharge"
+        ]
+      },
+      "ChargeMode": {
+        "description": "Charging mode.",
+        "type": "string",
+        "enum": [
+          "off",
+          "now",
+          "minpv",
+          "pv"
+        ]
+      },
+      "Rate": {
+        "description": "A time slot with an associated price or emission value.",
+        "type": "object",
+        "properties": {
+          "start": {
+            "description": "Start of the time slot.",
+            "type": "string",
+            "format": "date-time"
+          },
+          "end": {
+            "description": "End of the time slot.",
+            "type": "string",
+            "format": "date-time"
+          },
+          "value": {
+            "description": "Price per kWh in the configured currency or emissions in g/kWh.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "start",
+          "end",
+          "value"
+        ]
+      },
+      "StaticEnergyPlan": {
+        "description": "Charging plan with an energy goal.",
+        "type": "object",
+        "properties": {
+          "energy": {
+            "description": "Energy goal in kWh.",
+            "type": "number"
+          },
+          "time": {
+            "description": "Target time.",
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "energy",
+          "time"
+        ]
+      },
+      "PlanStrategy": {
+        "description": "Charging plan strategy.",
+        "type": "object",
+        "properties": {
+          "continuous": {
+            "description": "Force continuous charging without gaps.",
+            "type": "boolean"
+          },
+          "precondition": {
+            "description": "Duration of uninterrupted charging directly before the target time, in seconds.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "continuous",
+          "precondition"
+        ]
+      },
+      "ChargerStatusReason": {
+        "description": "Reason why the charger is waiting.",
+        "type": "string",
+        "enum": [
+          "unknown",
+          "waitingforauthorization",
+          "disconnectrequired"
+        ]
+      },
+      "PhaseAction": {
+        "description": "Pending phase switching action in solar mode.",
+        "type": "string",
+        "enum": [
+          "inactive",
+          "scale1p",
+          "scale3p"
+        ]
+      },
+      "PvAction": {
+        "description": "Pending charge start or stop action in solar mode.",
+        "type": "string",
+        "enum": [
+          "inactive",
+          "enable",
+          "disable"
+        ]
+      },
+      "LoadpointSuggestion": {
+        "description": "Battery optimizer suggestion for a loadpoint.",
+        "type": "object",
+        "properties": {
+          "action": {
+            "description": "Suggested charging action.",
+            "type": "string",
+            "enum": [
+              "charge",
+              "stop"
+            ]
+          },
+          "charge": {
+            "description": "Recommended charge power in W.",
+            "type": "number"
+          },
+          "discharge": {
+            "description": "Recommended discharge power in W.",
+            "type": "number"
+          },
+          "actionable": {
+            "description": "Suggestion differs from the current operating mode.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "LoadpointUi": {
+        "description": "Display-only UI settings of a loadpoint.",
+        "type": "object",
+        "properties": {
+          "minTemp": {
+            "description": "Lower bound of the temperature scale for heating devices, in degrees.",
+            "type": "number"
+          },
+          "maxTemp": {
+            "description": "Upper bound of the temperature scale for heating devices, in degrees.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "minTemp",
+          "maxTemp"
+        ]
+      },
+      "Loadpoint": {
+        "description": "A charging location with a charger, an optional dedicated meter and an optional vehicle.",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Unique loadpoint identifier used in API routes and configuration.",
+            "type": "string"
+          },
+          "batteryBoost": {
+            "description": "Battery boost is active. When enabled, home battery power is used for fast charging.",
+            "type": "boolean"
+          },
+          "chargeCurrents": {
+            "description": "Charging current per phase in A.",
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
+          },
+          "chargeDuration": {
+            "description": "Duration of the current charging session in seconds.",
+            "type": "number"
+          },
+          "chargePower": {
+            "description": "Current charging power in W.",
+            "type": "number"
+          },
+          "chargeRemainingDuration": {
+            "description": "Estimated remaining charging time in seconds.",
+            "type": "number"
+          },
+          "chargeRemainingEnergy": {
+            "description": "Estimated remaining energy in kWh.",
+            "type": "number"
+          },
+          "chargeTotalImport": {
+            "description": "Total energy imported by the charge meter in kWh.",
+            "type": "number"
+          },
+          "chargeVoltages": {
+            "description": "Charging voltage per phase in V.",
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
+          },
+          "chargedEnergy": {
+            "description": "Energy charged in the current charging session in kWh.",
+            "type": "number"
+          },
+          "chargerFeatureAutodetectDisabled": {
+            "description": "The connected vehicle is not identified automatically by its status.",
+            "type": "boolean"
+          },
+          "chargerFeatureAverage": {
+            "description": "Values are averaged.",
+            "type": "boolean"
+          },
+          "chargerFeatureCacheable": {
+            "description": "Values are cached.",
+            "type": "boolean"
+          },
+          "chargerFeatureClimaterDisabled": {
+            "description": "The climater state of the connected vehicle is ignored for charge control.",
+            "type": "boolean"
+          },
+          "chargerFeatureCoarseCurrent": {
+            "description": "Charger only supports full ampere steps for current control.",
+            "type": "boolean"
+          },
+          "chargerFeatureContinuous": {
+            "description": "Charger is a heating device where disabled means normal operation.",
+            "type": "boolean"
+          },
+          "chargerFeatureHeating": {
+            "description": "Charger is a heating device. SoC values represent temperature in degrees.",
+            "type": "boolean"
+          },
+          "chargerFeatureIntegratedDevice": {
+            "description": "Charger is an always-connected device without vehicles and charging sessions, like a heat pump.",
+            "type": "boolean"
+          },
+          "chargerFeatureOffline": {
+            "description": "The connected vehicle only provides data while charging.",
+            "type": "boolean"
+          },
+          "chargerFeatureRetryable": {
+            "description": "Vehicle API calls are retried on failure.",
+            "type": "boolean"
+          },
+          "chargerFeatureStreaming": {
+            "description": "The connected vehicle pushes data updates instead of being polled.",
+            "type": "boolean"
+          },
+          "chargerFeatureSwitchDevice": {
+            "description": "Charger is a switchable device without current control, like a heat pump or switch socket.",
+            "type": "boolean"
+          },
+          "chargerFeatureWakeUpDisabled": {
+            "description": "No wake-up calls are sent to the connected vehicle.",
+            "type": "boolean"
+          },
+          "chargerFeatureWelcomeCharge": {
+            "description": "The connected vehicle may need a short welcome charge to start communicating.",
+            "type": "boolean"
+          },
+          "chargerIcon": {
+            "description": "Charger icon name for UI display.",
+            "type": "string",
+            "nullable": true
+          },
+          "chargerPhases1p3p": {
+            "description": "Charger supports automatic switching between 1-phase and 3-phase charging.",
+            "type": "boolean"
+          },
+          "chargerSinglePhase": {
+            "description": "Charger is physically connected with a single phase.",
+            "type": "boolean"
+          },
+          "chargerStatusReason": {
+            "description": "Reason why the charger is waiting, like a pending authorization or a required disconnect.",
+            "nullable": true,
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ChargerStatusReason"
+              }
+            ]
+          },
+          "charging": {
+            "description": "A vehicle is connected and charging.",
+            "type": "boolean"
+          },
+          "connected": {
+            "description": "A vehicle is connected to the charger.",
+            "type": "boolean"
+          },
+          "connectedDuration": {
+            "description": "Duration since the vehicle was connected, in seconds.",
+            "type": "number"
+          },
+          "disableDelay": {
+            "description": "Delay before charging stops in solar mode, in seconds.",
+            "type": "number"
+          },
+          "disableThreshold": {
+            "description": "Grid draw power above which charging stops in solar mode, in W.",
+            "type": "number"
+          },
+          "effectiveLimitSoc": {
+            "description": "Currently applied SoC limit in %.",
+            "type": "number"
+          },
+          "effectiveMaxCurrent": {
+            "description": "Currently applied maximum charging current in A.",
+            "type": "number"
+          },
+          "effectiveMinCurrent": {
+            "description": "Currently applied minimum charging current in A.",
+            "type": "number"
+          },
+          "effectiveMinSoc": {
+            "description": "Currently applied minimum SoC in %.",
+            "type": "number"
+          },
+          "effectivePlanId": {
+            "description": "Id of the currently applied charging plan. Zero if no plan is active.",
+            "type": "number"
+          },
+          "effectivePlanSoc": {
+            "description": "SoC goal in % of the currently applied charging plan.",
+            "type": "number"
+          },
+          "effectivePlanTime": {
+            "description": "Target time of the currently applied charging plan.",
+            "type": "string",
+            "nullable": true,
+            "format": "date-time"
+          },
+          "effectivePlanStrategy": {
+            "$ref": "#/components/schemas/PlanStrategy",
+            "description": "Currently applied charging plan strategy."
+          },
+          "effectivePriority": {
+            "description": "Currently applied priority.",
+            "type": "number"
+          },
+          "enableDelay": {
+            "description": "Delay before charging starts in solar mode, in seconds.",
+            "type": "number"
+          },
+          "enableThreshold": {
+            "description": "Available surplus power above which charging starts in solar mode, in W.",
+            "type": "number"
+          },
+          "enabled": {
+            "description": "Charger is currently allowed to charge.",
+            "type": "boolean"
+          },
+          "limitEnergy": {
+            "description": "Session energy limit in kWh. Zero means no limit.",
+            "type": "number"
+          },
+          "limitSoc": {
+            "description": "Session SoC limit in %. Zero means no limit.",
+            "type": "number"
+          },
+          "maxCurrent": {
+            "description": "Maximum charging current in A.",
+            "type": "number"
+          },
+          "minCurrent": {
+            "description": "Minimum charging current in A.",
+            "type": "number"
+          },
+          "minSoc": {
+            "description": "Minimum SoC in %. Vehicle is fast-charged until this level is reached.",
+            "type": "number"
+          },
+          "minSocNotReached": {
+            "description": "Vehicle SoC is below the configured minimum SoC.",
+            "type": "boolean"
+          },
+          "mode": {
+            "$ref": "#/components/schemas/ChargeMode",
+            "description": "Charging behavior."
+          },
+          "offeredCurrent": {
+            "description": "Current offered to the vehicle in A.",
+            "type": "number"
+          },
+          "phaseAction": {
+            "$ref": "#/components/schemas/PhaseAction",
+            "description": "Pending phase switching action in solar mode."
+          },
+          "phaseRemaining": {
+            "description": "Remaining time until the pending phase switching action executes, in seconds.",
+            "type": "number"
+          },
+          "phasesActive": {
+            "description": "Number of phases expected to be used for charging.",
+            "type": "number"
+          },
+          "phasesConfigured": {
+            "description": "Configured phase mode. 0 is automatic switching, 1 and 3 select a fixed phase count.",
+            "type": "number"
+          },
+          "plan": {
+            "description": "Time slots of the current charging plan.",
+            "type": "array",
+            "nullable": true,
+            "items": {
+              "$ref": "#/components/schemas/Rate"
+            }
+          },
+          "planActive": {
+            "description": "The current time slot is an active charging slot of the plan.",
+            "type": "boolean"
+          },
+          "planEnergy": {
+            "description": "Energy goal of the charging plan in kWh.",
+            "type": "number"
+          },
+          "planOverrun": {
+            "description": "Duration in seconds the charging plan is projected to miss its target time.",
+            "type": "number"
+          },
+          "planStrategy": {
+            "$ref": "#/components/schemas/PlanStrategy",
+            "description": "Charging plan strategy."
+          },
+          "planProjectedEnd": {
+            "description": "Projected end of the charging plan. End of the last planned slot.",
+            "type": "string",
+            "nullable": true,
+            "format": "date-time"
+          },
+          "planProjectedStart": {
+            "description": "Projected start of the charging plan. Start of the earliest planned slot.",
+            "type": "string",
+            "nullable": true,
+            "format": "date-time"
+          },
+          "planTime": {
+            "description": "Target time of the charging plan.",
+            "type": "string",
+            "nullable": true,
+            "format": "date-time"
+          },
+          "priority": {
+            "description": "Priority for surplus distribution. Higher number means higher priority.",
+            "type": "number"
+          },
+          "pvAction": {
+            "$ref": "#/components/schemas/PvAction",
+            "description": "Pending charge start or stop action in solar mode."
+          },
+          "pvRemaining": {
+            "description": "Remaining time until the pending charge start or stop action executes, in seconds.",
+            "type": "number"
+          },
+          "last24hEnergy": {
+            "type": "number"
+          },
+          "last7dEnergy": {
+            "type": "number"
+          },
+          "sessionCo2PerKWh": {
+            "description": "Average CO₂ emissions of the current charging session in g/kWh.",
+            "type": "number",
+            "nullable": true
+          },
+          "sessionEnergy": {
+            "description": "Energy charged in the current charging session in kWh.",
+            "type": "number"
+          },
+          "sessionPrice": {
+            "description": "Total cost of the current charging session in the configured currency.",
+            "type": "number",
+            "nullable": true
+          },
+          "sessionPricePerKWh": {
+            "description": "Average energy price of the current charging session per kWh in the configured currency.",
+            "type": "number",
+            "nullable": true
+          },
+          "sessionSolarPercentage": {
+            "description": "Share of solar energy in the current charging session in %.",
+            "type": "number"
+          },
+          "smartCostActive": {
+            "description": "Fast charging with cheap or clean grid energy is currently active.",
+            "type": "boolean"
+          },
+          "smartCostLimit": {
+            "description": "Price or emission limit for fast charging with grid energy.",
+            "type": "number",
+            "nullable": true
+          },
+          "smartCostNextStart": {
+            "description": "Start of the next fast charging period with cheap or clean grid energy.",
+            "type": "string",
+            "nullable": true,
+            "format": "date-time"
+          },
+          "smartFeedInPriorityActive": {
+            "description": "Charging pause for prioritized feed-in is currently active.",
+            "type": "boolean"
+          },
+          "smartFeedInPriorityLimit": {
+            "description": "Feed-in rate limit above which charging is paused.",
+            "type": "number",
+            "nullable": true
+          },
+          "smartFeedInPriorityNextStart": {
+            "description": "Start of the next charging pause for prioritized feed-in.",
+            "type": "string",
+            "nullable": true,
+            "format": "date-time"
+          },
+          "suggestion": {
+            "description": "Charging suggestion from the battery optimizer.",
+            "nullable": true,
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/LoadpointSuggestion"
+              }
+            ]
+          },
+          "title": {
+            "description": "Loadpoint title for UI display.",
+            "type": "string"
+          },
+          "todayEnergy": {
+            "type": "number"
+          },
+          "vehicleClimaterActive": {
+            "description": "Climater of the connected vehicle is active.",
+            "type": "boolean",
+            "nullable": true
+          },
+          "vehicleDetectionActive": {
+            "description": "Automatic vehicle detection is running.",
+            "type": "boolean"
+          },
+          "vehicleLimitSoc": {
+            "description": "SoC limit configured in the vehicle itself, in %.",
+            "type": "number"
+          },
+          "vehicleName": {
+            "description": "Unique name of the connected vehicle. Empty for guest vehicles.",
+            "type": "string"
+          },
+          "vehicleOdometer": {
+            "description": "Odometer reading of the connected vehicle in km.",
+            "type": "number"
+          },
+          "vehicleRange": {
+            "description": "Range of the connected vehicle in km.",
+            "type": "number"
+          },
+          "vehicleSoc": {
+            "description": "Charge level of the connected vehicle in %. Temperature in degrees for heating devices.",
+            "type": "number"
+          },
+          "vehicleTitle": {
+            "description": "Title of the connected vehicle for UI display.",
+            "type": "string"
+          },
+          "vehicleWelcomeActive": {
+            "description": "A short welcome charge is active to enable vehicle communication.",
+            "type": "boolean"
+          },
+          "batteryBoostLimit": {
+            "description": "SoC limit for battery boost in %.",
+            "type": "number"
+          },
+          "ui": {
+            "$ref": "#/components/schemas/LoadpointUi",
+            "description": "Display-only UI settings."
+          }
+        },
+        "required": [
+          "name",
+          "batteryBoost",
+          "chargeDuration",
+          "chargePower",
+          "chargedEnergy",
+          "chargerFeatureAutodetectDisabled",
+          "chargerFeatureAverage",
+          "chargerFeatureCacheable",
+          "chargerFeatureClimaterDisabled",
+          "chargerFeatureCoarseCurrent",
+          "chargerFeatureContinuous",
+          "chargerFeatureHeating",
+          "chargerFeatureIntegratedDevice",
+          "chargerFeatureOffline",
+          "chargerFeatureRetryable",
+          "chargerFeatureStreaming",
+          "chargerFeatureSwitchDevice",
+          "chargerFeatureWakeUpDisabled",
+          "chargerFeatureWelcomeCharge",
+          "chargerIcon",
+          "chargerPhases1p3p",
+          "chargerSinglePhase",
+          "charging",
+          "connected",
+          "connectedDuration",
+          "disableDelay",
+          "disableThreshold",
+          "effectiveLimitSoc",
+          "effectiveMaxCurrent",
+          "effectiveMinCurrent",
+          "effectiveMinSoc",
+          "effectivePlanId",
+          "effectivePlanSoc",
+          "effectivePlanTime",
+          "effectivePlanStrategy",
+          "effectivePriority",
+          "enableDelay",
+          "enableThreshold",
+          "enabled",
+          "limitEnergy",
+          "limitSoc",
+          "maxCurrent",
+          "minCurrent",
+          "minSoc",
+          "minSocNotReached",
+          "mode",
+          "offeredCurrent",
+          "phaseAction",
+          "phaseRemaining",
+          "phasesActive",
+          "phasesConfigured",
+          "plan",
+          "planActive",
+          "planEnergy",
+          "planOverrun",
+          "planStrategy",
+          "planProjectedEnd",
+          "planProjectedStart",
+          "planTime",
+          "priority",
+          "pvAction",
+          "pvRemaining",
+          "sessionCo2PerKWh",
+          "sessionEnergy",
+          "sessionPrice",
+          "sessionPricePerKWh",
+          "sessionSolarPercentage",
+          "smartCostActive",
+          "smartCostLimit",
+          "smartCostNextStart",
+          "smartFeedInPriorityActive",
+          "smartFeedInPriorityLimit",
+          "smartFeedInPriorityNextStart",
+          "title",
+          "vehicleClimaterActive",
+          "vehicleDetectionActive",
+          "vehicleLimitSoc",
+          "vehicleName",
+          "vehicleOdometer",
+          "vehicleRange",
+          "vehicleSoc",
+          "vehicleTitle",
+          "vehicleWelcomeActive",
+          "batteryBoostLimit"
+        ]
+      },
+      "ForecastSlot": {
+        "description": "A forecast value for a time slot.",
+        "type": "object",
+        "properties": {
+          "start": {
+            "description": "Start of the time slot.",
+            "type": "string",
+            "format": "date-time"
+          },
+          "end": {
+            "description": "End of the time slot.",
+            "type": "string",
+            "format": "date-time"
+          },
+          "value": {
+            "description": "Forecast value of the time slot. Unit depends on the forecast type.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "start",
+          "end",
+          "value"
+        ]
+      },
+      "EnergyByDay": {
+        "description": "Expected solar production energy of a day.",
+        "type": "object",
+        "properties": {
+          "energy": {
+            "description": "Expected production energy in kWh.",
+            "type": "number"
+          },
+          "complete": {
+            "description": "Forecast data covers the whole day.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "energy",
+          "complete"
+        ]
+      },
+      "TimeseriesEntry": {
+        "description": "A forecast value at a point in time.",
+        "type": "object",
+        "properties": {
+          "val": {
+            "description": "Forecast power in W.",
+            "type": "number"
+          },
+          "ts": {
+            "description": "Time of the forecast value.",
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "val",
+          "ts"
+        ]
+      },
+      "SolarDetails": {
+        "description": "Solar production forecast.",
+        "type": "object",
+        "properties": {
+          "scale": {
+            "description": "Correction factor applied to the forecast based on past production.",
+            "type": "number"
+          },
+          "today": {
+            "$ref": "#/components/schemas/EnergyByDay",
+            "description": "Expected production today."
+          },
+          "tomorrow": {
+            "$ref": "#/components/schemas/EnergyByDay",
+            "description": "Expected production tomorrow."
+          },
+          "dayAfterTomorrow": {
+            "$ref": "#/components/schemas/EnergyByDay",
+            "description": "Expected production the day after tomorrow."
+          },
+          "timeseries": {
+            "description": "Expected production power over time.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TimeseriesEntry"
+            }
+          }
+        }
+      },
+      "Forecast": {
+        "description": "Price, CO₂ and solar production forecasts.",
+        "type": "object",
+        "properties": {
+          "grid": {
+            "description": "Grid price forecast. Price per kWh in the configured currency per time slot.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            }
+          },
+          "co2": {
+            "description": "CO₂ emission forecast in g/kWh per time slot.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            }
+          },
+          "solar": {
+            "$ref": "#/components/schemas/SolarDetails",
+            "description": "Solar production forecast."
+          },
+          "planner": {
+            "description": "Charging cost forecast used by the plan optimizer per time slot.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            }
+          },
+          "feedin": {
+            "description": "Feed-in rate forecast. Rate per kWh in the configured currency per time slot.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            }
+          },
+          "temperature": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            }
+          }
+        }
+      },
+      "Currency": {
+        "description": "Currency in ISO 4217 format.",
+        "type": "string",
+        "enum": [
+          "AUD",
+          "BGN",
+          "BRL",
+          "CAD",
+          "CHF",
+          "CNY",
+          "CZK",
+          "EUR",
+          "GBP",
+          "HUF",
+          "ILS",
+          "JPY",
+          "NZD",
+          "NOK",
+          "PLN",
+          "RON",
+          "USD",
+          "DKK",
+          "SEK",
+          "ZAR",
+          "TRY",
+          "MYR"
+        ]
+      },
+      "FatalError": {
+        "description": "A fatal startup error.",
+        "type": "object",
+        "properties": {
+          "error": {
+            "description": "Error message.",
+            "type": "string"
+          },
+          "class": {
+            "description": "Device class the error originates from, like meter or charger.",
+            "type": "string"
+          },
+          "device": {
+            "description": "Name of the device that caused the error.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
+      "AuthProviders": {
+        "description": "Status of configured vehicle authentication providers, keyed by provider name.",
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "authenticated": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "id",
+            "authenticated"
+          ]
+        }
+      },
+      "BatterySuggestion": {
+        "description": "Battery optimizer suggestion for a home battery.",
+        "type": "object",
+        "properties": {
+          "action": {
+            "description": "Suggested operation mode.",
+            "type": "string",
+            "enum": [
+              "normal",
+              "hold",
+              "charge",
+              "holdcharge"
+            ]
+          },
+          "charge": {
+            "description": "Recommended charge power in W.",
+            "type": "number"
+          },
+          "discharge": {
+            "description": "Recommended discharge power in W.",
+            "type": "number"
+          },
+          "actionable": {
+            "description": "Suggestion differs from the current operating mode.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "BatteryMeter": {
+        "description": "Measurement data of a single home battery meter.",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Unique device name of the meter.",
+            "type": "string"
+          },
+          "power": {
+            "description": "Current power in W.",
+            "type": "number"
+          },
+          "title": {
+            "description": "Meter title for UI display.",
+            "type": "string"
+          },
+          "icon": {
+            "description": "Meter icon name for UI display.",
+            "type": "string"
+          },
+          "energy": {
+            "description": "Total energy in kWh.",
+            "type": "number"
+          },
+          "returnEnergy": {
+            "description": "Total exported energy in kWh.",
+            "type": "number"
+          },
+          "powers": {
+            "description": "Power per phase in W.",
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
+          },
+          "currents": {
+            "description": "Current per phase in A.",
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
+          },
+          "soc": {
+            "description": "Charge level in %.",
+            "type": "number"
+          },
+          "controllable": {
+            "description": "Battery supports external control of its operation mode.",
+            "type": "boolean"
+          },
+          "capacity": {
+            "description": "Battery capacity in kWh. Zero when not specified.",
+            "type": "number"
+          },
+          "suggestion": {
+            "$ref": "#/components/schemas/BatterySuggestion",
+            "description": "Battery optimizer suggestion."
+          }
+        },
+        "required": [
+          "capacity",
+          "controllable",
+          "power",
+          "soc"
+        ]
+      },
+      "BatteryForecastPoint": {
+        "description": "A projected home battery charge level at a point in time.",
+        "type": "object",
+        "properties": {
+          "soc": {
+            "description": "Projected charge level in %.",
+            "type": "number"
+          },
+          "time": {
+            "description": "Time of the projected charge level.",
+            "type": "string",
+            "format": "date-time"
+          },
+          "limit": {
+            "description": "The projection hits the upper or lower battery limit.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "soc",
+          "time"
+        ]
+      },
+      "BatteryForecast": {
+        "description": "Projected home battery charge levels based on the solar and price forecast.",
+        "type": "object",
+        "properties": {
+          "highest": {
+            "$ref": "#/components/schemas/BatteryForecastPoint",
+            "description": "Projected highest charge level."
+          },
+          "lowest": {
+            "$ref": "#/components/schemas/BatteryForecastPoint",
+            "description": "Projected lowest charge level."
+          }
+        }
+      },
+      "Battery": {
+        "description": "Home battery state. Aggregated across all battery meters.",
+        "type": "object",
+        "properties": {
+          "power": {
+            "description": "Current battery power in W. Positive means discharging, negative means charging.",
+            "type": "number"
+          },
+          "capacity": {
+            "description": "Total battery capacity in kWh.",
+            "type": "number"
+          },
+          "soc": {
+            "description": "Charge level in %. Weighted by capacity across all batteries.",
+            "type": "number"
+          },
+          "energy": {
+            "description": "Total battery energy in kWh.",
+            "type": "number"
+          },
+          "devices": {
+            "description": "Measurement data per battery meter.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/BatteryMeter"
+            }
+          },
+          "forecast": {
+            "$ref": "#/components/schemas/BatteryForecast",
+            "description": "Projected charge levels based on the solar and price forecast."
+          }
+        },
+        "required": [
+          "power",
+          "capacity",
+          "soc"
+        ]
+      },
+      "Meter": {
+        "description": "Measurement data of a single meter.",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Unique device name of the meter.",
+            "type": "string"
+          },
+          "power": {
+            "description": "Current power in W.",
+            "type": "number"
+          },
+          "title": {
+            "description": "Meter title for UI display.",
+            "type": "string"
+          },
+          "icon": {
+            "description": "Meter icon name for UI display.",
+            "type": "string"
+          },
+          "energy": {
+            "description": "Total energy in kWh.",
+            "type": "number"
+          },
+          "returnEnergy": {
+            "description": "Total exported energy in kWh.",
+            "type": "number"
+          },
+          "powers": {
+            "description": "Power per phase in W.",
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
+          },
+          "currents": {
+            "description": "Current per phase in A.",
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
+          }
+        },
+        "required": [
+          "power"
+        ]
+      },
+      "GenericConfigStatus": {
+        "description": "Configuration and runtime status of an integration. Structure depends on configuration.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "description": "Static configuration."
+          },
+          "status": {
+            "description": "Runtime status."
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "type": "string",
+            "enum": [
+              "file",
+              "db"
+            ]
+          }
+        }
+      },
+      "MqttConfig": {
+        "description": "MQTT integration configuration.",
+        "type": "object",
+        "properties": {
+          "broker": {
+            "description": "Broker address.",
+            "type": "string"
+          },
+          "topic": {
+            "description": "Root topic all values are published under.",
+            "type": "string"
+          },
+          "user": {
+            "description": "Broker username.",
+            "type": "string"
+          },
+          "password": {
+            "description": "Broker password. Redacted.",
+            "type": "string"
+          },
+          "clientID": {
+            "description": "MQTT client id.",
+            "type": "string"
+          },
+          "insecure": {
+            "description": "Skip TLS certificate verification.",
+            "type": "boolean"
+          },
+          "caCert": {
+            "description": "CA certificate for TLS connections.",
+            "type": "string"
+          },
+          "clientCert": {
+            "description": "Client certificate for TLS connections.",
+            "type": "string"
+          },
+          "clientKey": {
+            "description": "Client key for TLS connections.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "broker",
+          "topic"
+        ]
+      },
+      "InfluxConfig": {
+        "description": "InfluxDB integration configuration.",
+        "type": "object",
+        "properties": {
+          "url": {
+            "description": "InfluxDB server URL.",
+            "type": "string"
+          },
+          "database": {
+            "description": "Database name (InfluxDB 1.x) or bucket (InfluxDB 2.x).",
+            "type": "string"
+          },
+          "org": {
+            "description": "Organization (InfluxDB 2.x).",
+            "type": "string"
+          },
+          "token": {
+            "description": "Access token (InfluxDB 2.x). Redacted.",
+            "type": "string"
+          },
+          "user": {
+            "description": "Username (InfluxDB 1.x).",
+            "type": "string"
+          },
+          "password": {
+            "description": "Password (InfluxDB 1.x). Redacted.",
+            "type": "string"
+          },
+          "insecure": {
+            "description": "Skip TLS certificate verification.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "url",
+          "database",
+          "org"
+        ]
+      },
+      "Network": {
+        "description": "Network configuration.",
+        "type": "object",
+        "properties": {
+          "schema": {
+            "description": "URL schema, http or https.",
+            "type": "string"
+          },
+          "host": {
+            "description": "Hostname.",
+            "type": "string"
+          },
+          "port": {
+            "description": "HTTP port.",
+            "type": "number"
+          },
+          "externalUrl": {
+            "description": "Externally reachable URL.",
+            "type": "string"
+          },
+          "internalUrl": {
+            "description": "URL in the local network.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "host",
+          "port"
+        ]
+      },
+      "HemsConfig": {
+        "description": "Home energy management system configuration.",
+        "type": "object",
+        "properties": {
+          "configured": {
+            "description": "A home energy management system is configured.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "configured"
+        ]
+      },
+      "HemsStatus": {
+        "description": "Current external limits imposed by the home energy management system.",
+        "type": "object",
+        "properties": {
+          "dimmed": {
+            "description": "Consumption is currently limited.",
+            "type": "boolean"
+          },
+          "curtailed": {
+            "description": "Allowed feed-in in %. Values below 100 mean production is curtailed.",
+            "type": "number"
+          },
+          "maxConsumptionPower": {
+            "description": "Maximum allowed consumption power in W.",
+            "type": "number"
+          },
+          "maxProductionPower": {
+            "description": "Maximum allowed production power in W.",
+            "type": "number"
+          }
+        }
+      },
+      "Hems": {
+        "description": "Home energy management system integration.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/HemsConfig",
+            "description": "Static configuration."
+          },
+          "status": {
+            "$ref": "#/components/schemas/HemsStatus",
+            "description": "Runtime status."
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "type": "string",
+            "enum": [
+              "file",
+              "db"
+            ]
+          }
+        }
+      },
+      "ShmConfig": {
+        "description": "SMA Home Manager configuration.",
+        "type": "object",
+        "properties": {
+          "vendorId": {
+            "description": "SMA vendor id.",
+            "type": "string"
+          },
+          "deviceId": {
+            "description": "SMA device id.",
+            "type": "string"
+          },
+          "deviceSerial": {
+            "description": "SMA device serial.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "vendorId",
+          "deviceId"
+        ]
+      },
+      "SponsorStatus": {
+        "description": "Sponsorship status.",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Name of the sponsor.",
+            "type": "string"
+          },
+          "expiresAt": {
+            "description": "Expiry time of the sponsor token.",
+            "type": "string",
+            "format": "date-time"
+          },
+          "expiresSoon": {
+            "description": "Sponsor token expires soon.",
+            "type": "boolean"
+          },
+          "token": {
+            "description": "Sponsor token. Redacted.",
+            "type": "string"
+          }
+        }
+      },
+      "Sponsor": {
+        "description": "Sponsorship status.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "description": "Static configuration."
+          },
+          "status": {
+            "$ref": "#/components/schemas/SponsorStatus",
+            "description": "Runtime status."
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "type": "string",
+            "enum": [
+              "file",
+              "db"
+            ]
+          }
+        }
+      },
+      "Certificate": {
+        "description": "A TLS certificate key pair.",
+        "type": "object",
+        "properties": {
+          "public": {
+            "description": "Public certificate in PEM format.",
+            "type": "string"
+          },
+          "private": {
+            "description": "Private key in PEM format. Redacted.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "public",
+          "private"
+        ]
+      },
+      "EebusConfig": {
+        "description": "EEBus integration configuration.",
+        "type": "object",
+        "properties": {
+          "uri": {
+            "description": "URI the EEBus service listens on.",
+            "type": "string"
+          },
+          "port": {
+            "description": "Port the EEBus service listens on.",
+            "type": "number"
+          },
+          "shipid": {
+            "description": "SHIP id.",
+            "type": "string"
+          },
+          "interfaces": {
+            "description": "Network interfaces the EEBus service uses.",
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "certificate": {
+            "$ref": "#/components/schemas/Certificate",
+            "description": "TLS certificate."
+          }
+        },
+        "required": [
+          "port",
+          "shipid"
+        ]
+      },
+      "EebusStatus": {
+        "description": "EEBus runtime status.",
+        "type": "object",
+        "properties": {
+          "ski": {
+            "description": "SKI (subject key identifier) used for pairing.",
+            "type": "string"
+          },
+          "qr": {
+            "description": "QR code payload for pairing.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "ski"
+        ]
+      },
+      "Eebus": {
+        "description": "EEBus integration configuration and status.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/EebusConfig",
+            "description": "Static configuration."
+          },
+          "status": {
+            "$ref": "#/components/schemas/EebusStatus",
+            "description": "Runtime status."
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "type": "string",
+            "enum": [
+              "file",
+              "db"
+            ]
+          }
+        }
+      },
+      "RemoteConfig": {
+        "description": "Remote access configuration.",
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "description": "Remote access is enabled.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "enabled"
+        ]
+      },
+      "RemoteStatus": {
+        "description": "Remote access connection status.",
+        "type": "object",
+        "properties": {
+          "connected": {
+            "description": "Connection to the remote access server is established.",
+            "type": "boolean"
+          },
+          "url": {
+            "description": "Remote access URL.",
+            "type": "string"
+          },
+          "loginBlocked": {
+            "description": "Remote login attempts are currently blocked by the rate limiter.",
+            "type": "boolean"
+          },
+          "lastSeen": {
+            "description": "Last remote activity per client, keyed by username. RFC3339 timestamps.",
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "connected",
+          "loginBlocked"
+        ]
+      },
+      "Remote": {
+        "description": "Remote access configuration and connection status.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/RemoteConfig",
+            "description": "Static configuration."
+          },
+          "status": {
+            "$ref": "#/components/schemas/RemoteStatus",
+            "description": "Runtime status."
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "type": "string",
+            "enum": [
+              "file",
+              "db"
+            ]
+          }
+        }
+      },
+      "ModbusProxyReadonly": {
+        "description": "How the Modbus proxy handles write requests.",
+        "type": "string",
+        "enum": [
+          "false",
+          "true",
+          "deny"
+        ]
+      },
+      "ModbusBaudrate": {
+        "description": "Serial baud rate.",
+        "type": "number",
+        "enum": [
+          1200,
+          9600,
+          19200,
+          38400,
+          57600,
+          115200
+        ]
+      },
+      "ModbusComset": {
+        "description": "Serial communication parameters.",
+        "type": "string",
+        "enum": [
+          "8N1",
+          "8E1",
+          "8N2"
+        ]
+      },
+      "ModbusProxySettings": {
+        "description": "Connection settings of a Modbus device.",
+        "type": "object",
+        "properties": {
+          "uri": {
+            "description": "Device address for TCP connections.",
+            "type": "string"
+          },
+          "rtu": {
+            "description": "Use RTU protocol over TCP.",
+            "type": "boolean"
+          },
+          "device": {
+            "description": "Serial device path.",
+            "type": "string"
+          },
+          "baudrate": {
+            "$ref": "#/components/schemas/ModbusBaudrate",
+            "description": "Serial baud rate."
+          },
+          "comset": {
+            "$ref": "#/components/schemas/ModbusComset",
+            "description": "Serial communication parameters."
+          }
+        }
+      },
+      "ModbusProxy": {
+        "description": "A Modbus proxy forwarding requests to a physical device.",
+        "type": "object",
+        "properties": {
+          "port": {
+            "description": "Port the proxy listens on.",
+            "type": "number"
+          },
+          "readonly": {
+            "$ref": "#/components/schemas/ModbusProxyReadonly",
+            "description": "How write requests are handled."
+          },
+          "settings": {
+            "$ref": "#/components/schemas/ModbusProxySettings",
+            "description": "Connection settings of the physical device."
+          }
+        },
+        "required": [
+          "port",
+          "readonly",
+          "settings"
+        ]
+      },
+      "MessagingEvent": {
+        "description": "A configured notification message.",
+        "type": "object",
+        "properties": {
+          "title": {
+            "description": "Message title template.",
+            "type": "string"
+          },
+          "msg": {
+            "description": "Message body template.",
+            "type": "string"
+          },
+          "disabled": {
+            "description": "Notifications for this event are disabled.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "title",
+          "msg",
+          "disabled"
+        ]
+      },
+      "MessagingEvents": {
+        "description": "Configured notification messages, keyed by event type.",
+        "type": "object",
+        "properties": {
+          "start": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "stop": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "connect": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "disconnect": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "soc": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "guest": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "asleep": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "planoverrun": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "suggestion": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          }
+        },
+        "required": [
+          "start",
+          "stop",
+          "connect",
+          "disconnect",
+          "soc",
+          "guest",
+          "asleep",
+          "planoverrun",
+          "suggestion"
+        ],
+        "additionalProperties": false
+      },
+      "Circuit": {
+        "description": "A load management circuit limiting power and current of its assigned loadpoints.",
+        "type": "object",
+        "properties": {
+          "title": {
+            "description": "Circuit title for UI display.",
+            "type": "string"
+          },
+          "icon": {
+            "description": "Circuit icon name for UI display.",
+            "type": "string"
+          },
+          "parent": {
+            "description": "Name of the parent circuit.",
+            "type": "string"
+          },
+          "power": {
+            "description": "Current power in W.",
+            "type": "number"
+          },
+          "current": {
+            "description": "Current in A.",
+            "type": "number"
+          },
+          "maxPower": {
+            "description": "Maximum allowed power in W.",
+            "type": "number"
+          },
+          "maxCurrent": {
+            "description": "Maximum allowed current in A.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "power"
+        ]
+      },
+      "SmartCostType": {
+        "description": "Type of the smart charging limit.",
+        "type": "string",
+        "enum": [
+          "co2",
+          "pricedynamic",
+          "priceforecast"
+        ]
+      },
+      "DeviceColorEntry": {
+        "description": "Color assigned to a device for consistent UI display.",
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "color": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "title",
+          "color"
+        ]
+      },
+      "StaticSocPlan": {
+        "description": "Charging plan with a SoC goal.",
+        "type": "object",
+        "properties": {
+          "soc": {
+            "description": "SoC goal in %.",
+            "type": "number"
+          },
+          "time": {
+            "description": "Target time.",
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "soc",
+          "time"
+        ]
+      },
+      "StaticPlan": {
+        "description": "Charging plan with a fixed target time and a SoC or energy goal.",
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/StaticSocPlan"
+          },
+          {
+            "$ref": "#/components/schemas/StaticEnergyPlan"
+          }
+        ]
+      },
+      "RepeatingPlan": {
+        "description": "A repeating charging plan.",
+        "type": "object",
+        "properties": {
+          "weekdays": {
+            "description": "Weekdays the plan is active. 0 is Sunday, 6 is Saturday.",
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
+          },
+          "time": {
+            "description": "Target time in HH:MM format.",
+            "type": "string"
+          },
+          "tz": {
+            "description": "Time zone of the target time, like Europe/Berlin.",
+            "type": "string"
+          },
+          "soc": {
+            "description": "SoC goal in %.",
+            "type": "number"
+          },
+          "active": {
+            "description": "Plan is active.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "weekdays",
+          "time",
+          "tz",
+          "soc",
+          "active"
+        ]
+      },
+      "Vehicle": {
+        "description": "A configured vehicle.",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Unique vehicle name used in API routes and configuration.",
+            "type": "string"
+          },
+          "mode": {
+            "description": "Charge mode applied when the vehicle connects.",
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ChargeMode"
+              },
+              {
+                "type": "string",
+                "enum": [
+                  ""
+                ]
+              }
+            ]
+          },
+          "minSoc": {
+            "description": "Minimum SoC in %. Vehicle is fast-charged until this level is reached.",
+            "type": "number"
+          },
+          "limitSoc": {
+            "description": "SoC limit in %. Charging stops when reached.",
+            "type": "number"
+          },
+          "plan": {
+            "$ref": "#/components/schemas/StaticPlan",
+            "description": "Charging plan with a fixed target time and SoC or energy goal."
+          },
+          "repeatingPlans": {
+            "description": "Repeating charging plans.",
+            "type": "array",
+            "nullable": true,
+            "items": {
+              "$ref": "#/components/schemas/RepeatingPlan"
+            }
+          },
+          "planStrategy": {
+            "$ref": "#/components/schemas/PlanStrategy",
+            "description": "Charging plan strategy."
+          },
+          "title": {
+            "description": "Vehicle title for UI display.",
+            "type": "string"
+          },
+          "features": {
+            "description": "Feature flags of the vehicle implementation.",
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "capacity": {
+            "description": "Usable battery capacity in kWh.",
+            "type": "number"
+          },
+          "icon": {
+            "description": "Vehicle icon name for UI display.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "repeatingPlans",
+          "planStrategy",
+          "title"
+        ]
+      },
+      "StatisticsData": {
+        "description": "Aggregated charging statistics for a time period.",
+        "type": "object",
+        "properties": {
+          "avgCo2": {
+            "description": "Average CO₂ emissions in g/kWh.",
+            "type": "number"
+          },
+          "avgPrice": {
+            "description": "Average energy price per kWh in the configured currency.",
+            "type": "number"
+          },
+          "chargedKWh": {
+            "description": "Total charged energy in kWh.",
+            "type": "number"
+          },
+          "solarPercentage": {
+            "description": "Share of solar energy in %.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "avgCo2",
+          "avgPrice",
+          "chargedKWh",
+          "solarPercentage"
+        ]
+      },
+      "Statistics": {
+        "description": "Charging statistics, keyed by time period.",
+        "type": "object",
+        "properties": {
+          "30d": {
+            "$ref": "#/components/schemas/StatisticsData"
+          },
+          "365d": {
+            "$ref": "#/components/schemas/StatisticsData"
+          },
+          "thisYear": {
+            "$ref": "#/components/schemas/StatisticsData"
+          },
+          "total": {
+            "$ref": "#/components/schemas/StatisticsData"
+          }
+        },
+        "required": [
+          "30d",
+          "365d",
+          "thisYear",
+          "total"
+        ]
+      },
+      "OcppConfig": {
+        "description": "OCPP server configuration.",
+        "type": "object",
+        "properties": {
+          "port": {
+            "description": "Port the OCPP server listens on.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "port"
+        ]
+      },
+      "OcppConnectionStatus": {
+        "description": "Connection status of an OCPP station.",
+        "type": "string",
+        "enum": [
+          "unknown",
+          "configured",
+          "connected"
+        ]
+      },
+      "OcppStationStatus": {
+        "description": "Connection status of an OCPP station.",
+        "type": "object",
+        "properties": {
+          "id": {
+            "description": "Station id.",
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/components/schemas/OcppConnectionStatus",
+            "description": "Connection status."
+          }
+        },
+        "required": [
+          "id",
+          "status"
+        ]
+      },
+      "OcppStatus": {
+        "description": "OCPP server status.",
+        "type": "object",
+        "properties": {
+          "externalUrl": {
+            "description": "Externally reachable URL of the OCPP server.",
+            "type": "string"
+          },
+          "stations": {
+            "description": "Connection status per configured station.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/OcppStationStatus"
+            }
+          }
+        },
+        "required": [
+          "stations"
+        ]
+      },
+      "Ocpp": {
+        "description": "OCPP server configuration and status.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/OcppConfig"
+          },
+          "status": {
+            "$ref": "#/components/schemas/OcppStatus"
+          }
+        },
+        "required": [
+          "config",
+          "status"
+        ]
+      },
+      "OcppForwarderRule": {
+        "description": "A rule forwarding an OCPP station to an upstream backend.",
+        "type": "object",
+        "properties": {
+          "stationId": {
+            "description": "Station id to forward.",
+            "type": "string"
+          },
+          "upstreamUrl": {
+            "description": "URL of the upstream OCPP backend.",
+            "type": "string"
+          },
+          "password": {
+            "description": "Password for upstream authentication. Redacted.",
+            "type": "string"
+          },
+          "upstreamStationId": {
+            "description": "Station id used towards the upstream backend.",
+            "type": "string"
+          },
+          "username": {
+            "description": "Username for upstream authentication.",
+            "type": "string"
+          },
+          "insecure": {
+            "description": "Skip TLS certificate verification.",
+            "type": "boolean"
+          },
+          "caCert": {
+            "description": "CA certificate for TLS connections.",
+            "type": "string"
+          },
+          "readOnly": {
+            "description": "Only forward read operations to the station.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "stationId",
+          "upstreamUrl"
+        ]
+      },
+      "OcppForwarderSession": {
+        "description": "Connection status of an OCPP forwarder rule.",
+        "type": "object",
+        "properties": {
+          "chargerId": {
+            "description": "Charger id.",
+            "type": "string"
+          },
+          "upstreamUrl": {
+            "description": "URL of the upstream OCPP backend.",
+            "type": "string"
+          },
+          "upstreamConnected": {
+            "description": "Connection to the upstream backend is established.",
+            "type": "boolean"
+          },
+          "error": {
+            "description": "Last connection error.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "chargerId",
+          "upstreamUrl",
+          "upstreamConnected"
+        ]
+      },
+      "OcppForwarder": {
+        "description": "OCPP forwarder rules and upstream connection status.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "description": "Static configuration.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/OcppForwarderRule"
+            }
+          },
+          "status": {
+            "description": "Runtime status.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/OcppForwarderSession"
+            }
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "type": "string",
+            "enum": [
+              "file",
+              "db"
+            ]
+          }
+        }
+      },
+      "State": {
+        "description": "Complete system state as returned by /api/state and pushed via websocket and MQTT. This structure mirrors the internal UI state and carries no compatibility promise. Fields may change or disappear between releases.",
+        "type": "object",
+        "properties": {
+          "telemetry": {
+            "description": "Telemetry is enabled.",
+            "type": "boolean"
+          },
+          "experimental": {
+            "description": "Experimental UI features are enabled.",
+            "type": "boolean"
+          },
+          "setupRequired": {
+            "description": "Initial setup is required.",
+            "type": "boolean"
+          },
+          "startupCompleted": {
+            "description": "Startup has completed.",
+            "type": "boolean"
+          },
+          "apiReady": {
+            "description": "HTTP API is ready to accept requests.",
+            "type": "boolean"
+          },
+          "loadpoints": {
+            "description": "Charging locations. One entry per configured loadpoint.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Loadpoint"
+            }
+          },
+          "forecast": {
+            "$ref": "#/components/schemas/Forecast",
+            "description": "Price, CO₂ and solar production forecasts."
+          },
+          "currency": {
+            "$ref": "#/components/schemas/Currency",
+            "description": "Configured currency for all monetary values."
+          },
+          "fatal": {
+            "description": "Fatal startup errors.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/FatalError"
+            }
+          },
+          "authProviders": {
+            "$ref": "#/components/schemas/AuthProviders",
+            "description": "Status of configured vehicle authentication providers, keyed by provider name."
+          },
+          "version": {
+            "description": "Running evcc version.",
+            "type": "string"
+          },
+          "availableVersion": {
+            "description": "Latest available evcc version.",
+            "type": "string"
+          },
+          "system": {
+            "description": "Operating system and architecture.",
+            "type": "string",
+            "example": "linux/amd64"
+          },
+          "timezone": {
+            "description": "Server time zone abbreviation and UTC offset.",
+            "type": "string",
+            "example": "CEST +02:00"
+          },
+          "battery": {
+            "$ref": "#/components/schemas/Battery",
+            "description": "Aggregated home battery state."
+          },
+          "batteryMode": {
+            "$ref": "#/components/schemas/BatteryMode",
+            "description": "Current operation mode of the home battery."
+          },
+          "grid": {
+            "$ref": "#/components/schemas/Meter",
+            "description": "Grid meter data."
+          },
+          "gridConfigured": {
+            "description": "A grid meter is configured.",
+            "type": "boolean"
+          },
+          "pv": {
+            "description": "Solar generation meters. One entry per configured pv meter.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Meter"
+            }
+          },
+          "pvPower": {
+            "description": "Total solar generation power in W. Sum of all pv meters.",
+            "type": "number"
+          },
+          "pvEnergy": {
+            "description": "Total solar generation energy in kWh.",
+            "type": "number"
+          },
+          "aux": {
+            "description": "Auxiliary consumption meters. Their power is treated as available for charging.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Meter"
+            }
+          },
+          "auxPower": {
+            "description": "Total power of all auxiliary meters in W.",
+            "type": "number"
+          },
+          "ext": {
+            "description": "Additional meters for monitoring purposes.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Meter"
+            }
+          },
+          "consumers": {
+            "description": "Consumption meters of individual devices for monitoring purposes.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Meter"
+            }
+          },
+          "homePower": {
+            "description": "Home consumption power in W.",
+            "type": "number"
+          },
+          "residualPower": {
+            "description": "Configured grid operating point in W. Positive values maintain grid import.",
+            "type": "number"
+          },
+          "greenShareHome": {
+            "description": "Share of green energy in home consumption, between 0 and 1.",
+            "type": "number"
+          },
+          "greenShareLoadpoints": {
+            "description": "Share of green energy used for charging, between 0 and 1.",
+            "type": "number"
+          },
+          "tariffs": {
+            "$ref": "#/components/schemas/GenericConfigStatus",
+            "description": "Configured tariffs. Structure depends on configuration."
+          },
+          "tariffGrid": {
+            "description": "Current grid energy price per kWh in the configured currency.",
+            "type": "number"
+          },
+          "tariffFeedIn": {
+            "description": "Current feed-in rate per kWh in the configured currency.",
+            "type": "number"
+          },
+          "tariffCo2": {
+            "description": "Current grid CO₂ emissions in g/kWh.",
+            "type": "number"
+          },
+          "tariffSolar": {
+            "description": "Current cost of solar generation per kWh in the configured currency.",
+            "type": "number"
+          },
+          "tariffPriceHome": {
+            "description": "Current energy price of home consumption per kWh, taking the green energy share into account.",
+            "type": "number"
+          },
+          "tariffPriceLoadpoints": {
+            "description": "Current energy price of charging per kWh, taking the green energy share into account.",
+            "type": "number"
+          },
+          "tariffCo2Home": {
+            "description": "Current CO₂ emissions of home consumption in g/kWh, taking the green energy share into account.",
+            "type": "number"
+          },
+          "tariffCo2Loadpoints": {
+            "description": "Current CO₂ emissions of charging in g/kWh, taking the green energy share into account.",
+            "type": "number"
+          },
+          "tariffTemperature": {
+            "type": "number"
+          },
+          "mqtt": {
+            "$ref": "#/components/schemas/MqttConfig",
+            "description": "MQTT integration configuration."
+          },
+          "influx": {
+            "$ref": "#/components/schemas/InfluxConfig",
+            "description": "InfluxDB integration configuration."
+          },
+          "network": {
+            "$ref": "#/components/schemas/Network",
+            "description": "Network configuration."
+          },
+          "hems": {
+            "$ref": "#/components/schemas/Hems",
+            "description": "Home energy management system integration."
+          },
+          "shm": {
+            "$ref": "#/components/schemas/ShmConfig",
+            "description": "SMA Home Manager configuration."
+          },
+          "sponsor": {
+            "$ref": "#/components/schemas/Sponsor",
+            "description": "Sponsorship status."
+          },
+          "eebus": {
+            "$ref": "#/components/schemas/Eebus",
+            "description": "EEBus integration configuration and status."
+          },
+          "remote": {
+            "$ref": "#/components/schemas/Remote",
+            "description": "Remote access configuration and connection status."
+          },
+          "modbusproxy": {
+            "description": "Modbus proxy configuration.",
+            "type": "array",
+            "nullable": true,
+            "items": {
+              "$ref": "#/components/schemas/ModbusProxy"
+            }
+          },
+          "messaging": {
+            "$ref": "#/components/schemas/GenericConfigStatus",
+            "description": "Messaging services configuration. Structure depends on configuration."
+          },
+          "messagingEvents": {
+            "description": "Configured notification messages per event type.",
+            "nullable": true,
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/MessagingEvents"
+              }
+            ]
+          },
+          "interval": {
+            "description": "Update interval of the control loop in seconds.",
+            "type": "number"
+          },
+          "circuits": {
+            "description": "Load management circuits, keyed by circuit name.",
+            "type": "object",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/Circuit"
+            }
+          },
+          "bufferSoc": {
+            "description": "Battery buffer SoC in %. Energy above this level may be used for charging in solar mode.",
+            "type": "number"
+          },
+          "prioritySoc": {
+            "description": "Battery priority SoC in %. Home battery is charged first while below this level.",
+            "type": "number"
+          },
+          "bufferStartSoc": {
+            "description": "Battery buffer start SoC in %. Solar charging starts automatically above this level.",
+            "type": "number"
+          },
+          "batteryDischargeControl": {
+            "description": "Home battery discharge is prevented during fast charging and planned charging.",
+            "type": "boolean"
+          },
+          "solarAdjusted": {
+            "type": "boolean"
+          },
+          "batteryGridChargeLimit": {
+            "description": "Price or emission limit for charging the home battery from grid.",
+            "type": "number",
+            "nullable": true
+          },
+          "batteryGridChargeActive": {
+            "description": "Home battery is currently charged from grid.",
+            "type": "boolean"
+          },
+          "smartCostAvailable": {
+            "description": "A dynamic grid price or CO₂ forecast is configured.",
+            "type": "boolean"
+          },
+          "smartCostType": {
+            "$ref": "#/components/schemas/SmartCostType",
+            "description": "Type of the smart charging limit, price based or emission based."
+          },
+          "smartFeedInPriorityAvailable": {
+            "description": "A feed-in tariff with forecast is configured.",
+            "type": "boolean"
+          },
+          "historyUpdated": {
+            "description": "Time of the last energy history update.",
+            "type": "string",
+            "format": "date-time"
+          },
+          "siteTitle": {
+            "description": "Configured site title.",
+            "type": "string"
+          },
+          "deviceColors": {
+            "description": "Colors assigned to devices for consistent UI display.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/DeviceColorEntry"
+            }
+          },
+          "vehicles": {
+            "description": "Configured vehicles, keyed by vehicle name.",
+            "type": "object",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/Vehicle"
+            }
+          },
+          "statistics": {
+            "$ref": "#/components/schemas/Statistics",
+            "description": "Charging statistics over different time periods."
+          },
+          "authDisabled": {
+            "description": "Authentication is disabled.",
+            "type": "boolean"
+          },
+          "config": {
+            "description": "Path of the evcc configuration file.",
+            "type": "string"
+          },
+          "database": {
+            "description": "Path of the evcc database.",
+            "type": "string"
+          },
+          "ocpp": {
+            "$ref": "#/components/schemas/Ocpp",
+            "description": "OCPP server configuration and connected stations."
+          },
+          "ocppforwarder": {
+            "$ref": "#/components/schemas/OcppForwarder",
+            "description": "OCPP forwarder rules and upstream connection status."
+          },
+          "optimizer": {
+            "description": "Battery optimizer is enabled.",
+            "type": "boolean"
+          },
+          "optimizerChargingStrategy": {
+            "description": "Selected battery optimizer charging strategy.",
+            "type": "string"
+          },
+          "optimizerChargingStrategies": {
+            "description": "Available battery optimizer charging strategies.",
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "mcp": {
+            "description": "Built-in MCP server is enabled.",
+            "type": "boolean"
+          },
+          "demoMode": {
+            "description": "Instance runs in demo mode.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "loadpoints",
+          "forecast",
+          "vehicles"
+        ]
+      }
+    },
+    "parameters": {
+      "adminPassword": {
+        "name": "X-Admin-Password",
+        "in": "header",
+        "description": "Admin password (required for session auth, not needed for API key)",
+        "schema": {
+          "$ref": "#/components/schemas/Password"
+        }
+      },
+      "id": {
+        "name": "id",
+        "description": "Loadpoint index starting at 1",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Id"
+        }
+      },
+      "phases": {
+        "name": "phases",
+        "description": "Number of phases. (0: auto, 1: 1-phase, 3: 3-phase)",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Phases"
+        }
+      },
+      "weekdays": {
+        "name": "weekdays",
+        "description": "The Weekdays",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Weekdays"
+        }
+      },
+      "hourMinuteTime": {
+        "name": "hourMinuteTime",
+        "description": "Time in `HOURS:MINUTES` format",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/HourMinuteTime"
+        }
+      },
+      "timezone": {
+        "name": "timezone",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/IANATimeZone"
+        }
+      },
+      "logAreas": {
+        "name": "areas",
+        "description": "Comma-separated list of log areas",
+        "in": "query",
+        "explode": true,
+        "schema": {
+          "$ref": "#/components/schemas/LogAreas"
+        }
+      },
+      "logLevel": {
+        "name": "level",
+        "description": "Log level",
+        "in": "query",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/LogLevel"
+        }
+      },
+      "delay": {
+        "name": "delay",
+        "description": "Duration in seconds.",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Delay"
+        }
+      },
+      "mode": {
+        "name": "mode",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/ChargeMode"
+        }
+      },
+      "soc": {
+        "name": "soc",
+        "description": "SOC in %",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Soc"
+        }
+      },
+      "temp": {
+        "name": "temp",
+        "description": "Temperature in °C",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Temp"
+        }
+      },
+      "timestamp": {
+        "name": "timestamp",
+        "description": "Timestamp in RFC3339 format",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Timestamp"
+        }
+      },
+      "vehicleName": {
+        "name": "name",
+        "description": "Vehicle name",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/VehicleName"
+        }
+      },
+      "current": {
+        "name": "current",
+        "description": "Electric current in A",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Current"
+        }
+      },
+      "power": {
+        "name": "power",
+        "description": "Power in W",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Power"
+        }
+      },
+      "energy": {
+        "name": "energy",
+        "description": "Energy in kWh",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Energy"
+        }
+      },
+      "threshold": {
+        "name": "threshold",
+        "description": "Power in W",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/Power"
+        }
+      },
+      "batteryMode": {
+        "name": "batteryMode",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/BatteryMode"
+        }
+      },
+      "costLimit": {
+        "name": "cost",
+        "description": "Cost limit in configured currency (default EUR) or CO2 limit in g/kWh",
+        "example": 0.25,
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "number"
+        }
+      },
+      "enable": {
+        "name": "enable",
+        "description": "Charging mode.",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "enum": [
+            "true",
+            "false",
+            "1",
+            "0"
+          ]
+        }
+      }
+    },
+    "responses": {
+      "NanoSecondsResult": {
+        "description": "Success - Number result - Unit is **nanoseconds**",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "integer"
+                }
+              }
+            }
+          }
+        }
+      },
+      "NumberResult": {
+        "description": "Success - Number result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "number"
+                }
+              }
+            }
+          }
+        }
+      },
+      "IntegerResult": {
+        "description": "Success - Integer result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "integer"
+                }
+              }
+            }
+          }
+        }
+      },
+      "SocResult": {
+        "description": "Success - Soc result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "object",
+                  "properties": {
+                    "soc": {
+                      "$ref": "#/components/schemas/Soc"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "PlanRatesResult": {
+        "description": "Success - PlanRates result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "$ref": "#/components/schemas/PlanRates"
+                }
+              }
+            }
+          }
+        }
+      },
+      "BooleanResult": {
+        "description": "Success - Boolean result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "boolean"
+                }
+              }
+            }
+          }
+        }
+      },
+      "NullResult": {
+        "description": "Success - Null result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "description": "Value is always null",
+                  "nullable": true,
+                  "type": "object"
+                }
+              }
+            }
+          }
+        }
+      },
+      "BlankResponse": {
+        "description": "Success - Blank response"
+      },
+      "SuccessResult": {
+        "description": "Success",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "string",
+                  "example": "OK"
+                }
+              }
+            }
+          }
+        }
+      },
+      "EmptyResult": {
+        "description": "Success - Empty result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object"
+            }
+          }
+        }
+      },
+      "Unauthorized": {
+        "description": "Unauthorized - Login and try again",
+        "content": {
+          "text/plain": {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "Unauthorized"
+              ]
+            }
+          }
+        }
+      },
+      "BatteryModeResult": {
+        "description": "Battery mode",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "integer",
+                  "description": "Battery mode. 0: unknown, 1: normal, 2: hold, 3: charge, 4: holdcharge",
+                  "minimum": 0,
+                  "maximum": 4
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "securitySchemes": {
+      "cookieAuth": {
+        "type": "apiKey",
+        "in": "cookie",
+        "name": "auth"
+      },
+      "bearerAuth": {
+        "type": "http",
+        "scheme": "bearer",
+        "description": "Long-lived API key (prefixed `evcc_`, managed via /auth/apikey).\nGrants access to /api/db/* without requiring the X-Admin-Password header.\n"
+      }
+    }
+  }
+}
diff --git a/server/mcp/openapi.md b/server/mcp/openapi.md
index 250894087..f1dc94eee 100644
--- a/server/mcp/openapi.md
+++ b/server/mcp/openapi.md
@@ -196,13 +196,13 @@ Directly controls the mode of all controllable batteries. evcc behavior like 'pr
 
 | Name | Type | Description |
 |------|------|-------------|
-| batteryMode | string | Battery mode |
+| batteryMode | string | Battery operation mode. |
 
 **Example call:**
 
 ```json
 call setExternalBatteryMode {
-  "batteryMode": "normal"
+  "batteryMode": "unknown"
 }
 ```
 
@@ -364,26 +364,6 @@ call setSolarAdjusted {
 }
 ```
 
-## getState
-
-Returns the complete state of the system. This structure is used by the UI. It can be filtered by JQ to only return a subset of the data.
-
-**Tags:** general
-
-**Arguments:**
-
-| Name | Type | Description |
-|------|------|-------------|
-| jq | string | Filter the state with JQ |
-
-**Example call:**
-
-```json
-call getState {
-  "jq": "example"
-}
-```
-
 ## removeGlobalSmartCostLimit
 
 Convenience method to remove limit for all loadpoints at once. Value is applied to each individual loadpoint.
@@ -1146,6 +1126,26 @@ call updateSession {
 }
 ```
 
+## 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.
+
+**Tags:** state
+
+**Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| jq | string | Filter the state with JQ |
+
+**Example call:**
+
+```json
+call state {
+  "jq": "example"
+}
+```
+
 ## clearCache
 
 Clears all cached data. This resets all cached values from tariffs, vehicle APIs, and other components that use caching.
diff --git a/server/openapi.go b/server/openapi.go
index b4a403938..972ae548c 100644
--- a/server/openapi.go
+++ b/server/openapi.go
@@ -1,4 +1,3 @@
 package server
 
-//go:generate go tool openapi openapi.yaml mcp/openapi.json
-//go:generate go tool openapi-mcp --doc mcp/openapi.md openapi.yaml
+//go:generate go tool openapi-mcp --doc mcp/openapi.md mcp/openapi.json
diff --git a/server/openapi.state.yaml b/server/openapi.state.yaml
new file mode 100644
index 000000000..e69ad4887
--- /dev/null
+++ b/server/openapi.state.yaml
@@ -0,0 +1,1814 @@
+# GENERATED FILE - DO NOT EDIT (source: assets/js/types/evcc.ts, update: npm run openapi)
+components:
+  schemas:
+    State:
+      description: Complete system state as returned by /api/state and pushed via websocket and MQTT. This structure mirrors the internal UI state and carries no compatibility promise. Fields may change or disappear between releases.
+      type: object
+      properties:
+        telemetry:
+          description: Telemetry is enabled.
+          type: boolean
+        experimental:
+          description: Experimental UI features are enabled.
+          type: boolean
+        setupRequired:
+          description: Initial setup is required.
+          type: boolean
+        startupCompleted:
+          description: Startup has completed.
+          type: boolean
+        apiReady:
+          description: HTTP API is ready to accept requests.
+          type: boolean
+        loadpoints:
+          description: Charging locations. One entry per configured loadpoint.
+          type: array
+          items:
+            $ref: "#/components/schemas/Loadpoint"
+        forecast:
+          $ref: "#/components/schemas/Forecast"
+          description: Price, CO₂ and solar production forecasts.
+        currency:
+          $ref: "#/components/schemas/Currency"
+          description: Configured currency for all monetary values.
+        fatal:
+          description: Fatal startup errors.
+          type: array
+          items:
+            $ref: "#/components/schemas/FatalError"
+        authProviders:
+          $ref: "#/components/schemas/AuthProviders"
+          description: Status of configured vehicle authentication providers, keyed by provider name.
+        version:
+          description: Running evcc version.
+          type: string
+        availableVersion:
+          description: Latest available evcc version.
+          type: string
+        system:
+          description: Operating system and architecture.
+          type: string
+          example: linux/amd64
+        timezone:
+          description: Server time zone abbreviation and UTC offset.
+          type: string
+          example: CEST +02:00
+        battery:
+          $ref: "#/components/schemas/Battery"
+          description: Aggregated home battery state.
+        batteryMode:
+          $ref: "#/components/schemas/BatteryMode"
+          description: Current operation mode of the home battery.
+        grid:
+          $ref: "#/components/schemas/Meter"
+          description: Grid meter data.
+        gridConfigured:
+          description: A grid meter is configured.
+          type: boolean
+        pv:
+          description: Solar generation meters. One entry per configured pv meter.
+          type: array
+          items:
+            $ref: "#/components/schemas/Meter"
+        pvPower:
+          description: Total solar generation power in W. Sum of all pv meters.
+          type: number
+        pvEnergy:
+          description: Total solar generation energy in kWh.
+          type: number
+        aux:
+          description: Auxiliary consumption meters. Their power is treated as available for charging.
+          type: array
+          items:
+            $ref: "#/components/schemas/Meter"
+        auxPower:
+          description: Total power of all auxiliary meters in W.
+          type: number
+        ext:
+          description: Additional meters for monitoring purposes.
+          type: array
+          items:
+            $ref: "#/components/schemas/Meter"
+        consumers:
+          description: Consumption meters of individual devices for monitoring purposes.
+          type: array
+          items:
+            $ref: "#/components/schemas/Meter"
+        homePower:
+          description: Home consumption power in W.
+          type: number
+        residualPower:
+          description: Configured grid operating point in W. Positive values maintain grid import.
+          type: number
+        greenShareHome:
+          description: Share of green energy in home consumption, between 0 and 1.
+          type: number
+        greenShareLoadpoints:
+          description: Share of green energy used for charging, between 0 and 1.
+          type: number
+        tariffs:
+          $ref: "#/components/schemas/GenericConfigStatus"
+          description: Configured tariffs. Structure depends on configuration.
+        tariffGrid:
+          description: Current grid energy price per kWh in the configured currency.
+          type: number
+        tariffFeedIn:
+          description: Current feed-in rate per kWh in the configured currency.
+          type: number
+        tariffCo2:
+          description: Current grid CO₂ emissions in g/kWh.
+          type: number
+        tariffSolar:
+          description: Current cost of solar generation per kWh in the configured currency.
+          type: number
+        tariffPriceHome:
+          description: Current energy price of home consumption per kWh, taking the green energy share into account.
+          type: number
+        tariffPriceLoadpoints:
+          description: Current energy price of charging per kWh, taking the green energy share into account.
+          type: number
+        tariffCo2Home:
+          description: Current CO₂ emissions of home consumption in g/kWh, taking the green energy share into account.
+          type: number
+        tariffCo2Loadpoints:
+          description: Current CO₂ emissions of charging in g/kWh, taking the green energy share into account.
+          type: number
+        tariffTemperature:
+          type: number
+        mqtt:
+          $ref: "#/components/schemas/MqttConfig"
+          description: MQTT integration configuration.
+        influx:
+          $ref: "#/components/schemas/InfluxConfig"
+          description: InfluxDB integration configuration.
+        network:
+          $ref: "#/components/schemas/Network"
+          description: Network configuration.
+        hems:
+          $ref: "#/components/schemas/Hems"
+          description: Home energy management system integration.
+        shm:
+          $ref: "#/components/schemas/ShmConfig"
+          description: SMA Home Manager configuration.
+        sponsor:
+          $ref: "#/components/schemas/Sponsor"
+          description: Sponsorship status.
+        eebus:
+          $ref: "#/components/schemas/Eebus"
+          description: EEBus integration configuration and status.
+        remote:
+          $ref: "#/components/schemas/Remote"
+          description: Remote access configuration and connection status.
+        modbusproxy:
+          description: Modbus proxy configuration.
+          type: array
+          nullable: true
+          items:
+            $ref: "#/components/schemas/ModbusProxy"
+        messaging:
+          $ref: "#/components/schemas/GenericConfigStatus"
+          description: Messaging services configuration. Structure depends on configuration.
+        messagingEvents:
+          description: Configured notification messages per event type.
+          nullable: true
+          allOf:
+            - $ref: "#/components/schemas/MessagingEvents"
+        interval:
+          description: Update interval of the control loop in seconds.
+          type: number
+        circuits:
+          description: Load management circuits, keyed by circuit name.
+          type: object
+          additionalProperties:
+            $ref: "#/components/schemas/Circuit"
+        bufferSoc:
+          description: Battery buffer SoC in %. Energy above this level may be used for charging in solar mode.
+          type: number
+        prioritySoc:
+          description: Battery priority SoC in %. Home battery is charged first while below this level.
+          type: number
+        bufferStartSoc:
+          description: Battery buffer start SoC in %. Solar charging starts automatically above this level.
+          type: number
+        batteryDischargeControl:
+          description: Home battery discharge is prevented during fast charging and planned charging.
+          type: boolean
+        solarAdjusted:
+          type: boolean
+        batteryGridChargeLimit:
+          description: Price or emission limit for charging the home battery from grid.
+          type: number
+          nullable: true
+        batteryGridChargeActive:
+          description: Home battery is currently charged from grid.
+          type: boolean
+        smartCostAvailable:
+          description: A dynamic grid price or CO₂ forecast is configured.
+          type: boolean
+        smartCostType:
+          $ref: "#/components/schemas/SmartCostType"
+          description: Type of the smart charging limit, price based or emission based.
+        smartFeedInPriorityAvailable:
+          description: A feed-in tariff with forecast is configured.
+          type: boolean
+        historyUpdated:
+          description: Time of the last energy history update.
+          type: string
+          format: date-time
+        siteTitle:
+          description: Configured site title.
+          type: string
+        deviceColors:
+          description: Colors assigned to devices for consistent UI display.
+          type: array
+          items:
+            $ref: "#/components/schemas/DeviceColorEntry"
+        vehicles:
+          description: Configured vehicles, keyed by vehicle name.
+          type: object
+          additionalProperties:
+            $ref: "#/components/schemas/Vehicle"
+        statistics:
+          $ref: "#/components/schemas/Statistics"
+          description: Charging statistics over different time periods.
+        authDisabled:
+          description: Authentication is disabled.
+          type: boolean
+        config:
+          description: Path of the evcc configuration file.
+          type: string
+        database:
+          description: Path of the evcc database.
+          type: string
+        ocpp:
+          $ref: "#/components/schemas/Ocpp"
+          description: OCPP server configuration and connected stations.
+        ocppforwarder:
+          $ref: "#/components/schemas/OcppForwarder"
+          description: OCPP forwarder rules and upstream connection status.
+        optimizer:
+          description: Battery optimizer is enabled.
+          type: boolean
+        optimizerChargingStrategy:
+          description: Selected battery optimizer charging strategy.
+          type: string
+        optimizerChargingStrategies:
+          description: Available battery optimizer charging strategies.
+          type: array
+          items:
+            type: string
+        mcp:
+          description: Built-in MCP server is enabled.
+          type: boolean
+        demoMode:
+          description: Instance runs in demo mode.
+          type: boolean
+      required:
+        - loadpoints
+        - forecast
+        - vehicles
+    AuthProviders:
+      description: Status of configured vehicle authentication providers, keyed by provider name.
+      type: object
+      additionalProperties:
+        type: object
+        properties:
+          id:
+            type: string
+          authenticated:
+            type: boolean
+        required:
+          - id
+          - authenticated
+    Battery:
+      description: Home battery state. Aggregated across all battery meters.
+      type: object
+      properties:
+        power:
+          description: Current battery power in W. Positive means discharging, negative means charging.
+          type: number
+        capacity:
+          description: Total battery capacity in kWh.
+          type: number
+        soc:
+          description: Charge level in %. Weighted by capacity across all batteries.
+          type: number
+        energy:
+          description: Total battery energy in kWh.
+          type: number
+        devices:
+          description: Measurement data per battery meter.
+          type: array
+          items:
+            $ref: "#/components/schemas/BatteryMeter"
+        forecast:
+          $ref: "#/components/schemas/BatteryForecast"
+          description: Projected charge levels based on the solar and price forecast.
+      required:
+        - power
+        - capacity
+        - soc
+    BatteryForecast:
+      description: Projected home battery charge levels based on the solar and price forecast.
+      type: object
+      properties:
+        highest:
+          $ref: "#/components/schemas/BatteryForecastPoint"
+          description: Projected highest charge level.
+        lowest:
+          $ref: "#/components/schemas/BatteryForecastPoint"
+          description: Projected lowest charge level.
+    BatteryForecastPoint:
+      description: A projected home battery charge level at a point in time.
+      type: object
+      properties:
+        soc:
+          description: Projected charge level in %.
+          type: number
+        time:
+          description: Time of the projected charge level.
+          type: string
+          format: date-time
+        limit:
+          description: The projection hits the upper or lower battery limit.
+          type: boolean
+      required:
+        - soc
+        - time
+    BatteryMeter:
+      description: Measurement data of a single home battery meter.
+      type: object
+      properties:
+        name:
+          description: Unique device name of the meter.
+          type: string
+        power:
+          description: Current power in W.
+          type: number
+        title:
+          description: Meter title for UI display.
+          type: string
+        icon:
+          description: Meter icon name for UI display.
+          type: string
+        energy:
+          description: Total energy in kWh.
+          type: number
+        returnEnergy:
+          description: Total exported energy in kWh.
+          type: number
+        powers:
+          description: Power per phase in W.
+          type: array
+          items:
+            type: number
+        currents:
+          description: Current per phase in A.
+          type: array
+          items:
+            type: number
+        soc:
+          description: Charge level in %.
+          type: number
+        controllable:
+          description: Battery supports external control of its operation mode.
+          type: boolean
+        capacity:
+          description: Battery capacity in kWh. Zero when not specified.
+          type: number
+        suggestion:
+          $ref: "#/components/schemas/BatterySuggestion"
+          description: Battery optimizer suggestion.
+      required:
+        - capacity
+        - controllable
+        - power
+        - soc
+    BatteryMode:
+      description: Battery operation mode.
+      type: string
+      enum:
+        - unknown
+        - normal
+        - hold
+        - charge
+        - holdcharge
+    BatterySuggestion:
+      description: Battery optimizer suggestion for a home battery.
+      type: object
+      properties:
+        action:
+          description: Suggested operation mode.
+          type: string
+          enum:
+            - normal
+            - hold
+            - charge
+            - holdcharge
+        charge:
+          description: Recommended charge power in W.
+          type: number
+        discharge:
+          description: Recommended discharge power in W.
+          type: number
+        actionable:
+          description: Suggestion differs from the current operating mode.
+          type: boolean
+      required:
+        - action
+    Certificate:
+      description: A TLS certificate key pair.
+      type: object
+      properties:
+        public:
+          description: Public certificate in PEM format.
+          type: string
+        private:
+          description: Private key in PEM format. Redacted.
+          type: string
+      required:
+        - public
+        - private
+    ChargeMode:
+      description: Charging mode.
+      type: string
+      enum:
+        - off
+        - now
+        - minpv
+        - pv
+    ChargerStatusReason:
+      description: Reason why the charger is waiting.
+      type: string
+      enum:
+        - unknown
+        - waitingforauthorization
+        - disconnectrequired
+    Circuit:
+      description: A load management circuit limiting power and current of its assigned loadpoints.
+      type: object
+      properties:
+        title:
+          description: Circuit title for UI display.
+          type: string
+        icon:
+          description: Circuit icon name for UI display.
+          type: string
+        parent:
+          description: Name of the parent circuit.
+          type: string
+        power:
+          description: Current power in W.
+          type: number
+        current:
+          description: Current in A.
+          type: number
+        maxPower:
+          description: Maximum allowed power in W.
+          type: number
+        maxCurrent:
+          description: Maximum allowed current in A.
+          type: number
+      required:
+        - power
+    Currency:
+      description: Currency in ISO 4217 format.
+      type: string
+      enum:
+        - AUD
+        - BGN
+        - BRL
+        - CAD
+        - CHF
+        - CNY
+        - CZK
+        - EUR
+        - GBP
+        - HUF
+        - ILS
+        - JPY
+        - NZD
+        - NOK
+        - PLN
+        - RON
+        - USD
+        - DKK
+        - SEK
+        - ZAR
+        - TRY
+        - MYR
+    DeviceColorEntry:
+      description: Color assigned to a device for consistent UI display.
+      type: object
+      properties:
+        title:
+          type: string
+        color:
+          type: string
+      required:
+        - title
+        - color
+    Eebus:
+      description: EEBus integration configuration and status.
+      type: object
+      properties:
+        config:
+          $ref: "#/components/schemas/EebusConfig"
+          description: Static configuration.
+        status:
+          $ref: "#/components/schemas/EebusStatus"
+          description: Runtime status.
+        yamlSource:
+          description: Source of the configuration, evcc.yaml file or database.
+          type: string
+          enum:
+            - file
+            - db
+    EebusConfig:
+      description: EEBus integration configuration.
+      type: object
+      properties:
+        uri:
+          description: URI the EEBus service listens on.
+          type: string
+        port:
+          description: Port the EEBus service listens on.
+          type: number
+        shipid:
+          description: SHIP id.
+          type: string
+        interfaces:
+          description: Network interfaces the EEBus service uses.
+          type: array
+          items:
+            type: string
+        certificate:
+          $ref: "#/components/schemas/Certificate"
+          description: TLS certificate.
+      required:
+        - port
+        - shipid
+    EebusStatus:
+      description: EEBus runtime status.
+      type: object
+      properties:
+        ski:
+          description: SKI (subject key identifier) used for pairing.
+          type: string
+        qr:
+          description: QR code payload for pairing.
+          type: string
+      required:
+        - ski
+    EnergyByDay:
+      description: Expected solar production energy of a day.
+      type: object
+      properties:
+        energy:
+          description: Expected production energy in kWh.
+          type: number
+        complete:
+          description: Forecast data covers the whole day.
+          type: boolean
+      required:
+        - energy
+        - complete
+    FatalError:
+      description: A fatal startup error.
+      type: object
+      properties:
+        error:
+          description: Error message.
+          type: string
+        class:
+          description: Device class the error originates from, like meter or charger.
+          type: string
+        device:
+          description: Name of the device that caused the error.
+          type: string
+      required:
+        - error
+    Forecast:
+      description: Price, CO₂ and solar production forecasts.
+      type: object
+      properties:
+        grid:
+          description: Grid price forecast. Price per kWh in the configured currency per time slot.
+          type: array
+          items:
+            $ref: "#/components/schemas/ForecastSlot"
+        co2:
+          description: CO₂ emission forecast in g/kWh per time slot.
+          type: array
+          items:
+            $ref: "#/components/schemas/ForecastSlot"
+        solar:
+          $ref: "#/components/schemas/SolarDetails"
+          description: Solar production forecast.
+        planner:
+          description: Charging cost forecast used by the plan optimizer per time slot.
+          type: array
+          items:
+            $ref: "#/components/schemas/ForecastSlot"
+        feedin:
+          description: Feed-in rate forecast. Rate per kWh in the configured currency per time slot.
+          type: array
+          items:
+            $ref: "#/components/schemas/ForecastSlot"
+        temperature:
+          type: array
+          items:
+            $ref: "#/components/schemas/ForecastSlot"
+    ForecastSlot:
+      description: A forecast value for a time slot.
+      type: object
+      properties:
+        start:
+          description: Start of the time slot.
+          type: string
+          format: date-time
+        end:
+          description: End of the time slot.
+          type: string
+          format: date-time
+        value:
+          description: Forecast value of the time slot. Unit depends on the forecast type.
+          type: number
+      required:
+        - start
+        - end
+        - value
+    GenericConfigStatus:
+      description: Configuration and runtime status of an integration. Structure depends on configuration.
+      type: object
+      properties:
+        config:
+          description: Static configuration.
+        status:
+          description: Runtime status.
+        yamlSource:
+          description: Source of the configuration, evcc.yaml file or database.
+          type: string
+          enum:
+            - file
+            - db
+    Hems:
+      description: Home energy management system integration.
+      type: object
+      properties:
+        config:
+          $ref: "#/components/schemas/HemsConfig"
+          description: Static configuration.
+        status:
+          $ref: "#/components/schemas/HemsStatus"
+          description: Runtime status.
+        yamlSource:
+          description: Source of the configuration, evcc.yaml file or database.
+          type: string
+          enum:
+            - file
+            - db
+    HemsConfig:
+      description: Home energy management system configuration.
+      type: object
+      properties:
+        configured:
+          description: A home energy management system is configured.
+          type: boolean
+      required:
+        - configured
+    HemsStatus:
+      description: Current external limits imposed by the home energy management system.
+      type: object
+      properties:
+        dimmed:
+          description: Consumption is currently limited.
+          type: boolean
+        curtailed:
+          description: Allowed feed-in in %. Values below 100 mean production is curtailed.
+          type: number
+        maxConsumptionPower:
+          description: Maximum allowed consumption power in W.
+          type: number
+        maxProductionPower:
+          description: Maximum allowed production power in W.
+          type: number
+    InfluxConfig:
+      description: InfluxDB integration configuration.
+      type: object
+      properties:
+        url:
+          description: InfluxDB server URL.
+          type: string
+        database:
+          description: Database name (InfluxDB 1.x) or bucket (InfluxDB 2.x).
+          type: string
+        org:
+          description: Organization (InfluxDB 2.x).
+          type: string
+        token:
+          description: Access token (InfluxDB 2.x). Redacted.
+          type: string
+        user:
+          description: Username (InfluxDB 1.x).
+          type: string
+        password:
+          description: Password (InfluxDB 1.x). Redacted.
+          type: string
+        insecure:
+          description: Skip TLS certificate verification.
+          type: boolean
+      required:
+        - url
+        - database
+        - org
+    Loadpoint:
+      description: A charging location with a charger, an optional dedicated meter and an optional vehicle.
+      type: object
+      properties:
+        name:
+          description: Unique loadpoint identifier used in API routes and configuration.
+          type: string
+        batteryBoost:
+          description: Battery boost is active. When enabled, home battery power is used for fast charging.
+          type: boolean
+        chargeCurrents:
+          description: Charging current per phase in A.
+          type: array
+          items:
+            type: number
+        chargeDuration:
+          description: Duration of the current charging session in seconds.
+          type: number
+        chargePower:
+          description: Current charging power in W.
+          type: number
+        chargeRemainingDuration:
+          description: Estimated remaining charging time in seconds.
+          type: number
+        chargeRemainingEnergy:
+          description: Estimated remaining energy in kWh.
+          type: number
+        chargeTotalImport:
+          description: Total energy imported by the charge meter in kWh.
+          type: number
+        chargeVoltages:
+          description: Charging voltage per phase in V.
+          type: array
+          items:
+            type: number
+        chargedEnergy:
+          description: Energy charged in the current charging session in kWh.
+          type: number
+        chargerFeatureAutodetectDisabled:
+          description: The connected vehicle is not identified automatically by its status.
+          type: boolean
+        chargerFeatureAverage:
+          description: Values are averaged.
+          type: boolean
+        chargerFeatureCacheable:
+          description: Values are cached.
+          type: boolean
+        chargerFeatureClimaterDisabled:
+          description: The climater state of the connected vehicle is ignored for charge control.
+          type: boolean
+        chargerFeatureCoarseCurrent:
+          description: Charger only supports full ampere steps for current control.
+          type: boolean
+        chargerFeatureContinuous:
+          description: Charger is a heating device where disabled means normal operation.
+          type: boolean
+        chargerFeatureHeating:
+          description: Charger is a heating device. SoC values represent temperature in degrees.
+          type: boolean
+        chargerFeatureIntegratedDevice:
+          description: Charger is an always-connected device without vehicles and charging sessions, like a heat pump.
+          type: boolean
+        chargerFeatureOffline:
+          description: The connected vehicle only provides data while charging.
+          type: boolean
+        chargerFeatureRetryable:
+          description: Vehicle API calls are retried on failure.
+          type: boolean
+        chargerFeatureStreaming:
+          description: The connected vehicle pushes data updates instead of being polled.
+          type: boolean
+        chargerFeatureSwitchDevice:
+          description: Charger is a switchable device without current control, like a heat pump or switch socket.
+          type: boolean
+        chargerFeatureWakeUpDisabled:
+          description: No wake-up calls are sent to the connected vehicle.
+          type: boolean
+        chargerFeatureWelcomeCharge:
+          description: The connected vehicle may need a short welcome charge to start communicating.
+          type: boolean
+        chargerIcon:
+          description: Charger icon name for UI display.
+          type: string
+          nullable: true
+        chargerPhases1p3p:
+          description: Charger supports automatic switching between 1-phase and 3-phase charging.
+          type: boolean
+        chargerSinglePhase:
+          description: Charger is physically connected with a single phase.
+          type: boolean
+        chargerStatusReason:
+          description: Reason why the charger is waiting, like a pending authorization or a required disconnect.
+          nullable: true
+          allOf:
+            - $ref: "#/components/schemas/ChargerStatusReason"
+        charging:
+          description: A vehicle is connected and charging.
+          type: boolean
+        connected:
+          description: A vehicle is connected to the charger.
+          type: boolean
+        connectedDuration:
+          description: Duration since the vehicle was connected, in seconds.
+          type: number
+        disableDelay:
+          description: Delay before charging stops in solar mode, in seconds.
+          type: number
+        disableThreshold:
+          description: Grid draw power above which charging stops in solar mode, in W.
+          type: number
+        effectiveLimitSoc:
+          description: Currently applied SoC limit in %.
+          type: number
+        effectiveMaxCurrent:
+          description: Currently applied maximum charging current in A.
+          type: number
+        effectiveMinCurrent:
+          description: Currently applied minimum charging current in A.
+          type: number
+        effectiveMinSoc:
+          description: Currently applied minimum SoC in %.
+          type: number
+        effectivePlanId:
+          description: Id of the currently applied charging plan. Zero if no plan is active.
+          type: number
+        effectivePlanSoc:
+          description: SoC goal in % of the currently applied charging plan.
+          type: number
+        effectivePlanTime:
+          description: Target time of the currently applied charging plan.
+          type: string
+          nullable: true
+          format: date-time
+        effectivePlanStrategy:
+          $ref: "#/components/schemas/PlanStrategy"
+          description: Currently applied charging plan strategy.
+        effectivePriority:
+          description: Currently applied priority.
+          type: number
+        enableDelay:
+          description: Delay before charging starts in solar mode, in seconds.
+          type: number
+        enableThreshold:
+          description: Available surplus power above which charging starts in solar mode, in W.
+          type: number
+        enabled:
+          description: Charger is currently allowed to charge.
+          type: boolean
+        limitEnergy:
+          description: Session energy limit in kWh. Zero means no limit.
+          type: number
+        limitSoc:
+          description: Session SoC limit in %. Zero means no limit.
+          type: number
+        maxCurrent:
+          description: Maximum charging current in A.
+          type: number
+        minCurrent:
+          description: Minimum charging current in A.
+          type: number
+        minSoc:
+          description: Minimum SoC in %. Vehicle is fast-charged until this level is reached.
+          type: number
+        minSocNotReached:
+          description: Vehicle SoC is below the configured minimum SoC.
+          type: boolean
+        mode:
+          $ref: "#/components/schemas/ChargeMode"
+          description: Charging behavior.
+        offeredCurrent:
+          description: Current offered to the vehicle in A.
+          type: number
+        phaseAction:
+          $ref: "#/components/schemas/PhaseAction"
+          description: Pending phase switching action in solar mode.
+        phaseRemaining:
+          description: Remaining time until the pending phase switching action executes, in seconds.
+          type: number
+        phasesActive:
+          description: Number of phases expected to be used for charging.
+          type: number
+        phasesConfigured:
+          description: Configured phase mode. 0 is automatic switching, 1 and 3 select a fixed phase count.
+          type: number
+        plan:
+          description: Time slots of the current charging plan.
+          type: array
+          nullable: true
+          items:
+            $ref: "#/components/schemas/Rate"
+        planActive:
+          description: The current time slot is an active charging slot of the plan.
+          type: boolean
+        planEnergy:
+          description: Energy goal of the charging plan in kWh.
+          type: number
+        planOverrun:
+          description: Duration in seconds the charging plan is projected to miss its target time.
+          type: number
+        planStrategy:
+          $ref: "#/components/schemas/PlanStrategy"
+          description: Charging plan strategy.
+        planProjectedEnd:
+          description: Projected end of the charging plan. End of the last planned slot.
+          type: string
+          nullable: true
+          format: date-time
+        planProjectedStart:
+          description: Projected start of the charging plan. Start of the earliest planned slot.
+          type: string
+          nullable: true
+          format: date-time
+        planTime:
+          description: Target time of the charging plan.
+          type: string
+          nullable: true
+          format: date-time
+        priority:
+          description: Priority for surplus distribution. Higher number means higher priority.
+          type: number
+        pvAction:
+          $ref: "#/components/schemas/PvAction"
+          description: Pending charge start or stop action in solar mode.
+        pvRemaining:
+          description: Remaining time until the pending charge start or stop action executes, in seconds.
+          type: number
+        last24hEnergy:
+          type: number
+        last7dEnergy:
+          type: number
+        sessionCo2PerKWh:
+          description: Average CO₂ emissions of the current charging session in g/kWh.
+          type: number
+          nullable: true
+        sessionEnergy:
+          description: Energy charged in the current charging session in kWh.
+          type: number
+        sessionPrice:
+          description: Total cost of the current charging session in the configured currency.
+          type: number
+          nullable: true
+        sessionPricePerKWh:
+          description: Average energy price of the current charging session per kWh in the configured currency.
+          type: number
+          nullable: true
+        sessionSolarPercentage:
+          description: Share of solar energy in the current charging session in %.
+          type: number
+        smartCostActive:
+          description: Fast charging with cheap or clean grid energy is currently active.
+          type: boolean
+        smartCostLimit:
+          description: Price or emission limit for fast charging with grid energy.
+          type: number
+          nullable: true
+        smartCostNextStart:
+          description: Start of the next fast charging period with cheap or clean grid energy.
+          type: string
+          nullable: true
+          format: date-time
+        smartFeedInPriorityActive:
+          description: Charging pause for prioritized feed-in is currently active.
+          type: boolean
+        smartFeedInPriorityLimit:
+          description: Feed-in rate limit above which charging is paused.
+          type: number
+          nullable: true
+        smartFeedInPriorityNextStart:
+          description: Start of the next charging pause for prioritized feed-in.
+          type: string
+          nullable: true
+          format: date-time
+        suggestion:
+          description: Charging suggestion from the battery optimizer.
+          nullable: true
+          allOf:
+            - $ref: "#/components/schemas/LoadpointSuggestion"
+        title:
+          description: Loadpoint title for UI display.
+          type: string
+        todayEnergy:
+          type: number
+        vehicleClimaterActive:
+          description: Climater of the connected vehicle is active.
+          type: boolean
+          nullable: true
+        vehicleDetectionActive:
+          description: Automatic vehicle detection is running.
+          type: boolean
+        vehicleLimitSoc:
+          description: SoC limit configured in the vehicle itself, in %.
+          type: number
+        vehicleName:
+          description: Unique name of the connected vehicle. Empty for guest vehicles.
+          type: string
+        vehicleOdometer:
+          description: Odometer reading of the connected vehicle in km.
+          type: number
+        vehicleRange:
+          description: Range of the connected vehicle in km.
+          type: number
+        vehicleSoc:
+          description: Charge level of the connected vehicle in %. Temperature in degrees for heating devices.
+          type: number
+        vehicleTitle:
+          description: Title of the connected vehicle for UI display.
+          type: string
+        vehicleWelcomeActive:
+          description: A short welcome charge is active to enable vehicle communication.
+          type: boolean
+        batteryBoostLimit:
+          description: SoC limit for battery boost in %.
+          type: number
+        ui:
+          $ref: "#/components/schemas/LoadpointUi"
+          description: Display-only UI settings.
+      required:
+        - name
+        - batteryBoost
+        - chargeDuration
+        - chargePower
+        - chargedEnergy
+        - chargerFeatureAutodetectDisabled
+        - chargerFeatureAverage
+        - chargerFeatureCacheable
+        - chargerFeatureClimaterDisabled
+        - chargerFeatureCoarseCurrent
+        - chargerFeatureContinuous
+        - chargerFeatureHeating
+        - chargerFeatureIntegratedDevice
+        - chargerFeatureOffline
+        - chargerFeatureRetryable
+        - chargerFeatureStreaming
+        - chargerFeatureSwitchDevice
+        - chargerFeatureWakeUpDisabled
+        - chargerFeatureWelcomeCharge
+        - chargerIcon
+        - chargerPhases1p3p
+        - chargerSinglePhase
+        - charging
+        - connected
+        - connectedDuration
+        - disableDelay
+        - disableThreshold
+        - effectiveLimitSoc
+        - effectiveMaxCurrent
+        - effectiveMinCurrent
+        - effectiveMinSoc
+        - effectivePlanId
+        - effectivePlanSoc
+        - effectivePlanTime
+        - effectivePlanStrategy
+        - effectivePriority
+        - enableDelay
+        - enableThreshold
+        - enabled
+        - limitEnergy
+        - limitSoc
+        - maxCurrent
+        - minCurrent
+        - minSoc
+        - minSocNotReached
+        - mode
+        - offeredCurrent
+        - phaseAction
+        - phaseRemaining
+        - phasesActive
+        - phasesConfigured
+        - plan
+        - planActive
+        - planEnergy
+        - planOverrun
+        - planStrategy
+        - planProjectedEnd
+        - planProjectedStart
+        - planTime
+        - priority
+        - pvAction
+        - pvRemaining
+        - sessionCo2PerKWh
+        - sessionEnergy
+        - sessionPrice
+        - sessionPricePerKWh
+        - sessionSolarPercentage
+        - smartCostActive
+        - smartCostLimit
+        - smartCostNextStart
+        - smartFeedInPriorityActive
+        - smartFeedInPriorityLimit
+        - smartFeedInPriorityNextStart
+        - title
+        - vehicleClimaterActive
+        - vehicleDetectionActive
+        - vehicleLimitSoc
+        - vehicleName
+        - vehicleOdometer
+        - vehicleRange
+        - vehicleSoc
+        - vehicleTitle
+        - vehicleWelcomeActive
+        - batteryBoostLimit
+    LoadpointSuggestion:
+      description: Battery optimizer suggestion for a loadpoint.
+      type: object
+      properties:
+        action:
+          description: Suggested charging action.
+          type: string
+          enum:
+            - charge
+            - stop
+        charge:
+          description: Recommended charge power in W.
+          type: number
+        discharge:
+          description: Recommended discharge power in W.
+          type: number
+        actionable:
+          description: Suggestion differs from the current operating mode.
+          type: boolean
+      required:
+        - action
+    LoadpointUi:
+      description: Display-only UI settings of a loadpoint.
+      type: object
+      properties:
+        minTemp:
+          description: Lower bound of the temperature scale for heating devices, in degrees.
+          type: number
+        maxTemp:
+          description: Upper bound of the temperature scale for heating devices, in degrees.
+          type: number
+      required:
+        - minTemp
+        - maxTemp
+    MessagingEvent:
+      description: A configured notification message.
+      type: object
+      properties:
+        title:
+          description: Message title template.
+          type: string
+        msg:
+          description: Message body template.
+          type: string
+        disabled:
+          description: Notifications for this event are disabled.
+          type: boolean
+      required:
+        - title
+        - msg
+        - disabled
+    MessagingEvents:
+      description: Configured notification messages, keyed by event type.
+      type: object
+      properties:
+        start:
+          $ref: "#/components/schemas/MessagingEvent"
+        stop:
+          $ref: "#/components/schemas/MessagingEvent"
+        connect:
+          $ref: "#/components/schemas/MessagingEvent"
+        disconnect:
+          $ref: "#/components/schemas/MessagingEvent"
+        soc:
+          $ref: "#/components/schemas/MessagingEvent"
+        guest:
+          $ref: "#/components/schemas/MessagingEvent"
+        asleep:
+          $ref: "#/components/schemas/MessagingEvent"
+        planoverrun:
+          $ref: "#/components/schemas/MessagingEvent"
+        suggestion:
+          $ref: "#/components/schemas/MessagingEvent"
+      required:
+        - start
+        - stop
+        - connect
+        - disconnect
+        - soc
+        - guest
+        - asleep
+        - planoverrun
+        - suggestion
+      additionalProperties: false
+    Meter:
+      description: Measurement data of a single meter.
+      type: object
+      properties:
+        name:
+          description: Unique device name of the meter.
+          type: string
+        power:
+          description: Current power in W.
+          type: number
+        title:
+          description: Meter title for UI display.
+          type: string
+        icon:
+          description: Meter icon name for UI display.
+          type: string
+        energy:
+          description: Total energy in kWh.
+          type: number
+        returnEnergy:
+          description: Total exported energy in kWh.
+          type: number
+        powers:
+          description: Power per phase in W.
+          type: array
+          items:
+            type: number
+        currents:
+          description: Current per phase in A.
+          type: array
+          items:
+            type: number
+      required:
+        - power
+    ModbusBaudrate:
+      description: Serial baud rate.
+      type: number
+      enum:
+        - 1200
+        - 9600
+        - 19200
+        - 38400
+        - 57600
+        - 115200
+    ModbusComset:
+      description: Serial communication parameters.
+      type: string
+      enum:
+        - 8N1
+        - "8E1"
+        - 8N2
+    ModbusProxy:
+      description: A Modbus proxy forwarding requests to a physical device.
+      type: object
+      properties:
+        port:
+          description: Port the proxy listens on.
+          type: number
+        readonly:
+          $ref: "#/components/schemas/ModbusProxyReadonly"
+          description: How write requests are handled.
+        settings:
+          $ref: "#/components/schemas/ModbusProxySettings"
+          description: Connection settings of the physical device.
+      required:
+        - port
+        - readonly
+        - settings
+    ModbusProxyReadonly:
+      description: How the Modbus proxy handles write requests.
+      type: string
+      enum:
+        - "false"
+        - "true"
+        - deny
+    ModbusProxySettings:
+      description: Connection settings of a Modbus device.
+      type: object
+      properties:
+        uri:
+          description: Device address for TCP connections.
+          type: string
+        rtu:
+          description: Use RTU protocol over TCP.
+          type: boolean
+        device:
+          description: Serial device path.
+          type: string
+        baudrate:
+          $ref: "#/components/schemas/ModbusBaudrate"
+          description: Serial baud rate.
+        comset:
+          $ref: "#/components/schemas/ModbusComset"
+          description: Serial communication parameters.
+    MqttConfig:
+      description: MQTT integration configuration.
+      type: object
+      properties:
+        broker:
+          description: Broker address.
+          type: string
+        topic:
+          description: Root topic all values are published under.
+          type: string
+        user:
+          description: Broker username.
+          type: string
+        password:
+          description: Broker password. Redacted.
+          type: string
+        clientID:
+          description: MQTT client id.
+          type: string
+        insecure:
+          description: Skip TLS certificate verification.
+          type: boolean
+        caCert:
+          description: CA certificate for TLS connections.
+          type: string
+        clientCert:
+          description: Client certificate for TLS connections.
+          type: string
+        clientKey:
+          description: Client key for TLS connections.
+          type: string
+      required:
+        - broker
+        - topic
+    Network:
+      description: Network configuration.
+      type: object
+      properties:
+        schema:
+          description: URL schema, http or https.
+          type: string
+        host:
+          description: Hostname.
+          type: string
+        port:
+          description: HTTP port.
+          type: number
+        externalUrl:
+          description: Externally reachable URL.
+          type: string
+        internalUrl:
+          description: URL in the local network.
+          type: string
+      required:
+        - host
+        - port
+    Ocpp:
+      description: OCPP server configuration and status.
+      type: object
+      properties:
+        config:
+          $ref: "#/components/schemas/OcppConfig"
+        status:
+          $ref: "#/components/schemas/OcppStatus"
+      required:
+        - config
+        - status
+    OcppConfig:
+      description: OCPP server configuration.
+      type: object
+      properties:
+        port:
+          description: Port the OCPP server listens on.
+          type: number
+      required:
+        - port
+    OcppConnectionStatus:
+      description: Connection status of an OCPP station.
+      type: string
+      enum:
+        - unknown
+        - configured
+        - connected
+    OcppForwarder:
+      description: OCPP forwarder rules and upstream connection status.
+      type: object
+      properties:
+        config:
+          description: Static configuration.
+          type: array
+          items:
+            $ref: "#/components/schemas/OcppForwarderRule"
+        status:
+          description: Runtime status.
+          type: array
+          items:
+            $ref: "#/components/schemas/OcppForwarderSession"
+        yamlSource:
+          description: Source of the configuration, evcc.yaml file or database.
+          type: string
+          enum:
+            - file
+            - db
+    OcppForwarderRule:
+      description: A rule forwarding an OCPP station to an upstream backend.
+      type: object
+      properties:
+        stationId:
+          description: Station id to forward.
+          type: string
+        upstreamUrl:
+          description: URL of the upstream OCPP backend.
+          type: string
+        password:
+          description: Password for upstream authentication. Redacted.
+          type: string
+        upstreamStationId:
+          description: Station id used towards the upstream backend.
+          type: string
+        username:
+          description: Username for upstream authentication.
+          type: string
+        insecure:
+          description: Skip TLS certificate verification.
+          type: boolean
+        caCert:
+          description: CA certificate for TLS connections.
+          type: string
+        readOnly:
+          description: Only forward read operations to the station.
+          type: boolean
+      required:
+        - stationId
+        - upstreamUrl
+    OcppForwarderSession:
+      description: Connection status of an OCPP forwarder rule.
+      type: object
+      properties:
+        chargerId:
+          description: Charger id.
+          type: string
+        upstreamUrl:
+          description: URL of the upstream OCPP backend.
+          type: string
+        upstreamConnected:
+          description: Connection to the upstream backend is established.
+          type: boolean
+        error:
+          description: Last connection error.
+          type: string
+      required:
+        - chargerId
+        - upstreamUrl
+        - upstreamConnected
+    OcppStationStatus:
+      description: Connection status of an OCPP station.
+      type: object
+      properties:
+        id:
+          description: Station id.
+          type: string
+        status:
+          $ref: "#/components/schemas/OcppConnectionStatus"
+          description: Connection status.
+      required:
+        - id
+        - status
+    OcppStatus:
+      description: OCPP server status.
+      type: object
+      properties:
+        externalUrl:
+          description: Externally reachable URL of the OCPP server.
+          type: string
+        stations:
+          description: Connection status per configured station.
+          type: array
+          items:
+            $ref: "#/components/schemas/OcppStationStatus"
+      required:
+        - stations
+    PhaseAction:
+      description: Pending phase switching action in solar mode.
+      type: string
+      enum:
+        - inactive
+        - scale1p
+        - scale3p
+    PlanStrategy:
+      description: Charging plan strategy.
+      type: object
+      properties:
+        continuous:
+          description: Force continuous charging without gaps.
+          type: boolean
+        precondition:
+          description: Duration of uninterrupted charging directly before the target time, in seconds.
+          type: number
+      required:
+        - continuous
+        - precondition
+    PvAction:
+      description: Pending charge start or stop action in solar mode.
+      type: string
+      enum:
+        - inactive
+        - enable
+        - disable
+    Rate:
+      description: A time slot with an associated price or emission value.
+      type: object
+      properties:
+        start:
+          description: Start of the time slot.
+          type: string
+          format: date-time
+        end:
+          description: End of the time slot.
+          type: string
+          format: date-time
+        value:
+          description: Price per kWh in the configured currency or emissions in g/kWh.
+          type: number
+      required:
+        - start
+        - end
+        - value
+    Remote:
+      description: Remote access configuration and connection status.
+      type: object
+      properties:
+        config:
+          $ref: "#/components/schemas/RemoteConfig"
+          description: Static configuration.
+        status:
+          $ref: "#/components/schemas/RemoteStatus"
+          description: Runtime status.
+        yamlSource:
+          description: Source of the configuration, evcc.yaml file or database.
+          type: string
+          enum:
+            - file
+            - db
+    RemoteConfig:
+      description: Remote access configuration.
+      type: object
+      properties:
+        enabled:
+          description: Remote access is enabled.
+          type: boolean
+      required:
+        - enabled
+    RemoteStatus:
+      description: Remote access connection status.
+      type: object
+      properties:
+        connected:
+          description: Connection to the remote access server is established.
+          type: boolean
+        url:
+          description: Remote access URL.
+          type: string
+        loginBlocked:
+          description: Remote login attempts are currently blocked by the rate limiter.
+          type: boolean
+        lastSeen:
+          description: Last remote activity per client, keyed by username. RFC3339 timestamps.
+          type: object
+          additionalProperties:
+            type: string
+      required:
+        - connected
+        - loginBlocked
+    RepeatingPlan:
+      description: A repeating charging plan.
+      type: object
+      properties:
+        weekdays:
+          description: Weekdays the plan is active. 0 is Sunday, 6 is Saturday.
+          type: array
+          items:
+            type: number
+        time:
+          description: Target time in HH:MM format.
+          type: string
+        tz:
+          description: Time zone of the target time, like Europe/Berlin.
+          type: string
+        soc:
+          description: SoC goal in %.
+          type: number
+        active:
+          description: Plan is active.
+          type: boolean
+      required:
+        - weekdays
+        - time
+        - tz
+        - soc
+        - active
+    ShmConfig:
+      description: SMA Home Manager configuration.
+      type: object
+      properties:
+        vendorId:
+          description: SMA vendor id.
+          type: string
+        deviceId:
+          description: SMA device id.
+          type: string
+        deviceSerial:
+          description: SMA device serial.
+          type: string
+      required:
+        - vendorId
+        - deviceId
+    SmartCostType:
+      description: Type of the smart charging limit.
+      type: string
+      enum:
+        - co2
+        - pricedynamic
+        - priceforecast
+    SolarDetails:
+      description: Solar production forecast.
+      type: object
+      properties:
+        scale:
+          description: Correction factor applied to the forecast based on past production.
+          type: number
+        today:
+          $ref: "#/components/schemas/EnergyByDay"
+          description: Expected production today.
+        tomorrow:
+          $ref: "#/components/schemas/EnergyByDay"
+          description: Expected production tomorrow.
+        dayAfterTomorrow:
+          $ref: "#/components/schemas/EnergyByDay"
+          description: Expected production the day after tomorrow.
+        timeseries:
+          description: Expected production power over time.
+          type: array
+          items:
+            $ref: "#/components/schemas/TimeseriesEntry"
+    Sponsor:
+      description: Sponsorship status.
+      type: object
+      properties:
+        config:
+          description: Static configuration.
+        status:
+          $ref: "#/components/schemas/SponsorStatus"
+          description: Runtime status.
+        yamlSource:
+          description: Source of the configuration, evcc.yaml file or database.
+          type: string
+          enum:
+            - file
+            - db
+    SponsorStatus:
+      description: Sponsorship status.
+      type: object
+      properties:
+        name:
+          description: Name of the sponsor.
+          type: string
+        expiresAt:
+          description: Expiry time of the sponsor token.
+          type: string
+          format: date-time
+        expiresSoon:
+          description: Sponsor token expires soon.
+          type: boolean
+        token:
+          description: Sponsor token. Redacted.
+          type: string
+    StaticEnergyPlan:
+      description: Charging plan with an energy goal.
+      type: object
+      properties:
+        energy:
+          description: Energy goal in kWh.
+          type: number
+        time:
+          description: Target time.
+          type: string
+          format: date-time
+      required:
+        - energy
+        - time
+    StaticPlan:
+      description: Charging plan with a fixed target time and a SoC or energy goal.
+      anyOf:
+        - $ref: "#/components/schemas/StaticSocPlan"
+        - $ref: "#/components/schemas/StaticEnergyPlan"
+    StaticSocPlan:
+      description: Charging plan with a SoC goal.
+      type: object
+      properties:
+        soc:
+          description: SoC goal in %.
+          type: number
+        time:
+          description: Target time.
+          type: string
+          format: date-time
+      required:
+        - soc
+        - time
+    Statistics:
+      description: Charging statistics, keyed by time period.
+      type: object
+      properties:
+        30d:
+          $ref: "#/components/schemas/StatisticsData"
+        365d:
+          $ref: "#/components/schemas/StatisticsData"
+        thisYear:
+          $ref: "#/components/schemas/StatisticsData"
+        total:
+          $ref: "#/components/schemas/StatisticsData"
+      required:
+        - 30d
+        - 365d
+        - thisYear
+        - total
+    StatisticsData:
+      description: Aggregated charging statistics for a time period.
+      type: object
+      properties:
+        avgCo2:
+          description: Average CO₂ emissions in g/kWh.
+          type: number
+        avgPrice:
+          description: Average energy price per kWh in the configured currency.
+          type: number
+        chargedKWh:
+          description: Total charged energy in kWh.
+          type: number
+        solarPercentage:
+          description: Share of solar energy in %.
+          type: number
+      required:
+        - avgCo2
+        - avgPrice
+        - chargedKWh
+        - solarPercentage
+    TimeseriesEntry:
+      description: A forecast value at a point in time.
+      type: object
+      properties:
+        val:
+          description: Forecast power in W.
+          type: number
+        ts:
+          description: Time of the forecast value.
+          type: string
+          format: date-time
+      required:
+        - val
+        - ts
+    Vehicle:
+      description: A configured vehicle.
+      type: object
+      properties:
+        name:
+          description: Unique vehicle name used in API routes and configuration.
+          type: string
+        mode:
+          description: Charge mode applied when the vehicle connects.
+          anyOf:
+            - $ref: "#/components/schemas/ChargeMode"
+            - type: string
+              enum:
+                - ""
+        minSoc:
+          description: Minimum SoC in %. Vehicle is fast-charged until this level is reached.
+          type: number
+        limitSoc:
+          description: SoC limit in %. Charging stops when reached.
+          type: number
+        plan:
+          $ref: "#/components/schemas/StaticPlan"
+          description: Charging plan with a fixed target time and SoC or energy goal.
+        repeatingPlans:
+          description: Repeating charging plans.
+          type: array
+          nullable: true
+          items:
+            $ref: "#/components/schemas/RepeatingPlan"
+        planStrategy:
+          $ref: "#/components/schemas/PlanStrategy"
+          description: Charging plan strategy.
+        title:
+          description: Vehicle title for UI display.
+          type: string
+        features:
+          description: Feature flags of the vehicle implementation.
+          type: array
+          items:
+            type: string
+        capacity:
+          description: Usable battery capacity in kWh.
+          type: number
+        icon:
+          description: Vehicle icon name for UI display.
+          type: string
+      required:
+        - repeatingPlans
+        - planStrategy
+        - title
diff --git a/server/openapi.yaml b/server/openapi.yaml
index 77b2c9f6c..faa15ff6b 100644
--- a/server/openapi.yaml
+++ b/server/openapi.yaml
@@ -8,6 +8,7 @@ info:
 servers:
   - url: https://demo.evcc.io/api
 tags:
+  - name: state
   - name: auth
   - name: battery
   - name: db
@@ -435,7 +436,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Mode"
+                $ref: "./openapi.state.yaml#/components/schemas/ChargeMode"
   /loadpoints/{id}/phases/{phases}:
     post:
       operationId: setLoadpointPhases
@@ -509,7 +510,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/StaticEnergyPlan"
+                $ref: "./openapi.state.yaml#/components/schemas/StaticEnergyPlan"
   /loadpoints/{id}/plan/repeating/preview/{soc}/{weekdays}/{hourMinuteTime}/{timezone}:
     get:
       operationId: previewLoadpointRepeatingPlan
@@ -576,14 +577,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/PlanStrategy"
+              $ref: "./openapi.state.yaml#/components/schemas/PlanStrategy"
       responses:
-        "200":
+        200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PlanStrategy"
+                $ref: "./openapi.state.yaml#/components/schemas/PlanStrategy"
   /loadpoints/{id}/priority/{priority}:
     post:
       operationId: setLoadpointPriority
@@ -931,13 +932,13 @@ paths:
           $ref: "#/components/responses/NumberResult"
   /state:
     get:
-      operationId: getState
+      operationId: state
       summary: System state
-      description: "Returns the complete state of the system. This structure is used by the UI. It can be filtered by JQ to only return a subset of the data."
+      description: "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."
       externalDocs:
         url: https://docs.evcc.io/integrations/rest-api
       tags:
-        - general
+        - state
       parameters:
         - name: jq
           in: query
@@ -957,7 +958,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/State"
+                $ref: "./openapi.state.yaml#/components/schemas/State"
   /system/log:
     get:
       operationId: getSystemLogs
@@ -1150,7 +1151,7 @@ paths:
                 type: object
                 properties:
                   mode:
-                    $ref: "#/components/schemas/Mode"
+                    $ref: "./openapi.state.yaml#/components/schemas/ChargeMode"
   /vehicles/{name}/plan/repeating:
     post:
       operationId: updateVehicleRepeatingPlans
@@ -1169,7 +1170,7 @@ paths:
             schema:
               type: array
               items:
-                $ref: "#/components/schemas/RepeatingPlan"
+                $ref: "./openapi.state.yaml#/components/schemas/RepeatingPlan"
       responses:
         "200":
           description: Success
@@ -1178,7 +1179,7 @@ paths:
               schema:
                 type: array
                 items:
-                  $ref: "#/components/schemas/RepeatingPlan"
+                  $ref: "./openapi.state.yaml#/components/schemas/RepeatingPlan"
   /vehicles/{name}/plan/soc:
     delete:
       operationId: deleteVehicleSocPlan
@@ -1234,14 +1235,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/PlanStrategy"
+              $ref: "./openapi.state.yaml#/components/schemas/PlanStrategy"
       responses:
-        "200":
+        200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PlanStrategy"
+                $ref: "./openapi.state.yaml#/components/schemas/PlanStrategy"
   /db/backup:
     get:
       operationId: downloadBackup
@@ -1419,16 +1420,6 @@ paths:
           description: Invalid parameters or database offline
 components:
   schemas:
-    BatteryMode:
-      description: Battery mode
-      type: string
-      example: normal
-      enum:
-        - unknown
-        - normal
-        - hold
-        - charge
-        - holdcharge
     ChangePassword:
       type: object
       properties:
@@ -1566,14 +1557,6 @@ components:
         - INFO
         - DEBUG
         - TRACE
-    Mode:
-      description: "Charging mode."
-      type: string
-      enum:
-        - "off"
-        - "now"
-        - "minpv"
-        - "pv"
     Odometer:
       nullable: true
       type: "number"
@@ -1612,51 +1595,10 @@ components:
       type: integer
       example: 3600
       minimum: 0
-    Rate:
-      type: object
-      description: A charging interval
-      properties:
-        start:
-          description: Start
-          $ref: "#/components/schemas/Timestamp"
-        end:
-          description: End
-          $ref: "#/components/schemas/Timestamp"
-        value:
-          description: Cost
-          type: number
-          minimum: 0
     Rates:
       type: array
       items:
-        $ref: "#/components/schemas/Rate"
-    PlanStrategy:
-      description: Charging plan strategy configuration
-      type: object
-      properties:
-        continuous:
-          description: "Force continuous planning"
-          type: boolean
-        precondition:
-          description: "Precondition duration in seconds"
-          type: integer
-          minimum: 0
-    RepeatingPlan:
-      externalDocs:
-        url: https://docs.evcc.io/en/features/plans#repeating-plans
-      type: object
-      properties:
-        active:
-          description: "Set plan active."
-          type: boolean
-        soc:
-          $ref: "#/components/schemas/Soc"
-        time:
-          $ref: "#/components/schemas/HourMinuteTime"
-        tz:
-          $ref: "#/components/schemas/IANATimeZone"
-        weekdays:
-          $ref: "#/components/schemas/Weekdays"
+        $ref: "./openapi.state.yaml#/components/schemas/Rate"
     Soc:
       description: SOC in %
       type: number
@@ -1668,27 +1610,6 @@ components:
       type: number
       example: 50
       minimum: 0
-    State:
-      description: "The actual state structure is not documented yet. Most values should be self-explanatory. Note: While the overall structure is quite stable, details may change between releases."
-      type: object
-    StaticEnergyPlan:
-      externalDocs:
-        url: https://docs.evcc.io/en/features/plans#energy-amount-plan
-      type: object
-      properties:
-        energy:
-          $ref: "#/components/schemas/Energy"
-        time:
-          $ref: "#/components/schemas/Timestamp"
-    StaticSocPlan:
-      externalDocs:
-        url: https://docs.evcc.io/en/features/plans#create-charging-plan
-      type: object
-      properties:
-        soc:
-          $ref: "#/components/schemas/Soc"
-        time:
-          $ref: "#/components/schemas/Timestamp"
     Timestamp:
       description: Timestamp in RFC3339 format
       type: string
@@ -1785,7 +1706,7 @@ components:
       in: path
       required: true
       schema:
-        $ref: "#/components/schemas/Mode"
+        $ref: "./openapi.state.yaml#/components/schemas/ChargeMode"
     soc:
       name: soc
       description: SOC in %
@@ -1847,7 +1768,7 @@ components:
       in: path
       required: true
       schema:
-        $ref: "#/components/schemas/BatteryMode"
+        $ref: "./openapi.state.yaml#/components/schemas/BatteryMode"
     costLimit:
       name: cost
       description: Cost limit in configured currency (default EUR) or CO2 limit in g/kWh
@@ -1874,19 +1795,28 @@ components:
       content:
         application/json:
           schema:
-            type: integer
+            type: object
+            properties:
+              result:
+                type: integer
     NumberResult:
       description: Success - Number result
       content:
         application/json:
           schema:
-            type: number
+            type: object
+            properties:
+              result:
+                type: number
     IntegerResult:
       description: Success - Integer result
       content:
         application/json:
           schema:
-            type: integer
+            type: object
+            properties:
+              result:
+                type: integer
     SocResult:
       description: Success - Soc result
       content:
@@ -1894,28 +1824,40 @@ components:
           schema:
             type: object
             properties:
-              soc:
-                $ref: "#/components/schemas/Soc"
+              result:
+                type: object
+                properties:
+                  soc:
+                    $ref: "#/components/schemas/Soc"
     PlanRatesResult:
       description: Success - PlanRates result
       content:
         application/json:
           schema:
-            $ref: "#/components/schemas/PlanRates"
+            type: object
+            properties:
+              result:
+                $ref: "#/components/schemas/PlanRates"
     BooleanResult:
       description: Success - Boolean result
       content:
         application/json:
           schema:
-            type: boolean
+            type: object
+            properties:
+              result:
+                type: boolean
     NullResult:
       description: Success - Null result
       content:
         application/json:
           schema:
-            description: Value is always null
-            nullable: true
-            type: "object"
+            type: object
+            properties:
+              result:
+                description: Value is always null
+                nullable: true
+                type: "object"
     BlankResponse:
       description: Success - Blank response
     SuccessResult:
@@ -1923,8 +1865,11 @@ components:
       content:
         application/json:
           schema:
-            type: string
-            example: "OK"
+            type: object
+            properties:
+              result:
+                type: string
+                example: "OK"
     EmptyResult:
       description: Success - Empty result
       content:
@@ -1944,10 +1889,13 @@ components:
       content:
         application/json:
           schema:
-            type: integer
-            description: "Battery mode. 0: unknown, 1: normal, 2: hold, 3: charge, 4: holdcharge"
-            minimum: 0
-            maximum: 4
+            type: object
+            properties:
+              result:
+                type: integer
+                description: "Battery mode. 0: unknown, 1: normal, 2: hold, 3: charge, 4: holdcharge"
+                minimum: 0
+                maximum: 4
   securitySchemes:
     cookieAuth:
       type: apiKey
diff --git a/server/openapi_test.go b/server/openapi_test.go
index bd1b6e38e..b10bae04f 100644
--- a/server/openapi_test.go
+++ b/server/openapi_test.go
@@ -9,6 +9,7 @@ import (
 
 func TestOpenAPIValidation(t *testing.T) {
 	loader := openapi3.NewLoader()
+	loader.IsExternalRefsAllowed = true
 	doc, err := loader.LoadFromFile("openapi.yaml")
 	require.NoError(t, err)
 	require.NoError(t, doc.Validate(loader.Context))
diff --git a/tests/state-api.spec.ts b/tests/state-api.spec.ts
new file mode 100644
index 000000000..527d1f975
--- /dev/null
+++ b/tests/state-api.spec.ts
@@ -0,0 +1,28 @@
+import { test, expect } from "@playwright/test";
+import { start, stop, baseUrl } from "./evcc";
+import { validateState } from "../scripts/state-schema/validate";
+
+test.use({ baseURL: baseUrl() });
+
+const CONFIG = "cmd/demo.yaml";
+
+test.beforeAll(async () => {
+  await start(CONFIG);
+});
+test.afterAll(async () => {
+  await stop();
+});
+
+test("/api/state matches the openapi State schema", async ({ request }) => {
+  // loadpoint values appear over the first update cycles, poll until stable
+  await expect
+    .poll(
+      async () => {
+        const res = await request.get("/api/state");
+        const { errors, undocumented } = validateState(await res.json());
+        return [...errors, ...undocumented];
+      },
+      { timeout: 30000 }
+    )
+    .toEqual([]);
+});
diff --git a/tsconfig.json b/tsconfig.json
index dd2d54772..7def18365 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -1,6 +1,6 @@
 {
   "extends": "@vue/tsconfig/tsconfig.dom.json",
-  "include": ["env.d.ts", "assets/js/**/*", "tests/**/*"],
+  "include": ["env.d.ts", "assets/js/**/*", "tests/**/*", "scripts/**/*"],
   "compilerOptions": {
     "allowUnreachableCode": false,
     "allowUnusedLabels": false,