From 88c517261680a74c52bf066274972f0ef5f7fed9 Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Mon, 6 Jul 2026 14:17:52 +0200
Subject: [PATCH 1/8] API: generate /api/state documentation from UI types

---
 .../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/types.ts        |   25 +
 assets/js/components/Loadpoints/Loadpoint.vue |    2 +-
 assets/js/components/Vehicles/Title.vue       |    2 +-
 assets/js/components/Vehicles/Vehicle.vue     |    2 +-
 assets/js/types/evcc.ts                       |  549 +++-
 eslint.config.mts                             |    1 +
 package-lock.json                             |  244 +-
 package.json                                  |    8 +-
 scripts/state-schema/index.ts                 |   34 +
 scripts/state-schema/openapi.ts               |   58 +
 scripts/state-schema/schemas.ts               |  182 ++
 scripts/state-schema/validate.ts              |   93 +
 server/mcp/openapi.json                       | 2323 ++++++++++++++++-
 server/mcp/openapi.md                         |    6 +-
 server/openapi.yaml                           | 1805 ++++++++++++-
 tests/state-api.spec.ts                       |   25 +
 tsconfig.json                                 |    2 +-
 24 files changed, 5203 insertions(+), 232 deletions(-)
 delete mode 100644 assets/js/components/ChargingPlans/types.d.ts
 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 tests/state-api.spec.ts

diff --git a/assets/js/components/ChargingPlans/ChargingPlan.vue b/assets/js/components/ChargingPlans/ChargingPlan.vue
index 3750c1cc936..6bb096a23be 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 03c5e817bb8..e575e4b1a42 100644
--- a/assets/js/components/ChargingPlans/ChargingPlanModal.vue
+++ b/assets/js/components/ChargingPlans/ChargingPlanModal.vue
@@ -85,13 +85,17 @@ import PlansSettings from "./PlansSettings.vue";
 import Arrival from "./Arrival.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 a8014a76bfe..0e63f3f8393 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 ba25e85622c..9a79fb49cc1 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 fc14630b0fe..e51addb2d8d 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 ea0caa4b41a..b8329b75680 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 91031a05c9f..00000000000
--- 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/types.ts b/assets/js/components/Forecast/types.ts
index 993be2a191a..afead1786ba 100644
--- a/assets/js/components/Forecast/types.ts
+++ b/assets/js/components/Forecast/types.ts
@@ -2,26 +2,51 @@ export function isForecastSlot(obj?: TimeseriesEntry | ForecastSlot): obj is For
   return (obj as ForecastSlot).start !== undefined;
 }
 
+/** 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[];
 }
diff --git a/assets/js/components/Loadpoints/Loadpoint.vue b/assets/js/components/Loadpoints/Loadpoint.vue
index 663f5f6ce86..e88d78e8b33 100644
--- a/assets/js/components/Loadpoints/Loadpoint.vue
+++ b/assets/js/components/Loadpoints/Loadpoint.vue
@@ -121,8 +121,8 @@ import type {
 	SMART_COST_TYPE,
 	BATTERY_MODE,
 	LoadpointUi,
+	PlanStrategy,
 } from "@/types/evcc";
-import type { PlanStrategy } from "@/components/ChargingPlans/types";
 
 export default defineComponent({
 	name: "Loadpoint",
diff --git a/assets/js/components/Vehicles/Title.vue b/assets/js/components/Vehicles/Title.vue
index 73c8b02a596..f4338019383 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 660fc854861..82882a114c3 100644
--- a/assets/js/components/Vehicles/Vehicle.vue
+++ b/assets/js/components/Vehicles/Vehicle.vue
@@ -98,8 +98,8 @@ import {
 	type VehicleStatus,
 	type Vehicle,
 	type LoadpointUi,
+	type PlanStrategy,
 } 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 152faa43e64..fb09fb3b68a 100644
--- a/assets/js/types/evcc.ts
+++ b/assets/js/types/evcc.ts
@@ -1,4 +1,3 @@
-import type { StaticPlan, RepeatingPlan, PlanStrategy } from "../components/ChargingPlans/types";
 import type { ForecastSlot, SolarDetails } from "../components/Forecast/types";
 
 // react-native-webview
@@ -21,164 +20,375 @@ 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.
+ * The overall structure is stable, details may change 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[];
-  tariffs?: ConfigStatus<unknown, unknown>;
+  /** Consumption meters of individual devices for monitoring purposes. */
+  consumers?: Meter[];
+  /** 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;
+  /** 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;
+  /** 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",
@@ -192,13 +402,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;
 }
 
@@ -278,11 +496,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",
@@ -299,84 +521,203 @@ 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;
+  /** 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;
+  /** 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;
+  /** 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;
+  /** Loadpoint title for UI display. */
   title: string;
+  /** 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;
 }
 
@@ -409,6 +750,7 @@ export enum THEME {
   DARK = "dark",
 }
 
+/** Currency in ISO 4217 format. */
 export enum CURRENCY {
   AUD = "AUD",
   BGN = "BGN",
@@ -442,6 +784,7 @@ export enum ICON_SIZE {
   XL = "xl",
 }
 
+/** Charging mode. */
 export enum CHARGE_MODE {
   OFF = "off",
   NOW = "now",
@@ -449,6 +792,7 @@ export enum CHARGE_MODE {
   PV = "pv",
 }
 
+/** Battery operation mode. */
 export enum BATTERY_MODE {
   UNKNOWN = "unknown",
   NORMAL = "normal",
@@ -464,18 +808,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",
@@ -499,20 +846,30 @@ export type SessionInfoKey =
   | "emission"
   | "co2";
 
+/** 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,
@@ -528,12 +885,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",
@@ -550,21 +909,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>;
 };
 
@@ -578,18 +948,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;
 };
 
@@ -599,12 +979,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 {
@@ -618,17 +1003,27 @@ export enum MESSAGING_EVENTS {
   PLANOVERRUN = "planoverrun",
 }
 
+/** 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;
 }
 
@@ -640,50 +1035,148 @@ 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;
 }
 
+/** 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. */
+  capacity: number;
 }
 
+/** 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;
+  /** 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;
 }
 
@@ -699,9 +1192,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;
 }
 
@@ -717,11 +1214,17 @@ export interface Slot {
   selectable?: boolean | null;
 }
 
+/** 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[];
 }
 
diff --git a/eslint.config.mts b/eslint.config.mts
index c4d9d0c01f7..a8878d649e2 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/package-lock.json b/package-lock.json
index cf48355c2ff..c382af5f3ad 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -56,6 +56,7 @@
         "@vue/eslint-config-typescript": "^14.8.0",
         "@vue/test-utils": "^2.4.11",
         "@vue/tsconfig": "^0.9.1",
+        "ajv": "^8.20.0",
         "body-parser": "^2.2.2",
         "cross-env": "^10.1.0",
         "eslint": "^9.39.4",
@@ -77,6 +78,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 +88,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 +2347,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 +2377,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",
@@ -5364,16 +5391,16 @@
       }
     },
     "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",
@@ -7561,6 +7588,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 +7618,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 +7844,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",
@@ -9186,9 +9254,9 @@
       "license": "MIT"
     },
     "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 +10069,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",
@@ -11195,6 +11273,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 +11659,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",
@@ -12536,6 +12634,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",
diff --git a/package.json b/package.json
index f6e3e24c83c..48ecc4943ba 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",
@@ -75,6 +76,7 @@
     "@vue/eslint-config-typescript": "^14.8.0",
     "@vue/test-utils": "^2.4.11",
     "@vue/tsconfig": "^0.9.1",
+    "ajv": "^8.20.0",
     "body-parser": "^2.2.2",
     "cross-env": "^10.1.0",
     "eslint": "^9.39.4",
@@ -96,6 +98,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 +108,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 00000000000..66e84e4de79
--- /dev/null
+++ b/scripts/state-schema/index.ts
@@ -0,0 +1,34 @@
+import { buildSchemas } from "./schemas";
+import { spliceOpenapi } from "./openapi";
+
+const command = process.argv[2] ?? "generate";
+
+switch (command) {
+  case "generate": {
+    const schemas = buildSchemas();
+    const changed = await spliceOpenapi(schemas);
+    console.log(
+      changed
+        ? `server/openapi.yaml updated (${Object.keys(schemas.defs).length} schemas)`
+        : "server/openapi.yaml unchanged"
+    );
+    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 00000000000..0eea7816d74
--- /dev/null
+++ b/scripts/state-schema/openapi.ts
@@ -0,0 +1,58 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { stringify } from "yaml";
+import prettier from "prettier";
+import type { StateSchemas } from "./schemas";
+
+const OPENAPI_PATH = "server/openapi.yaml";
+const BEGIN = "# GENERATED_STATE_SCHEMAS_BEGIN";
+const END = "# GENERATED_STATE_SCHEMAS_END";
+const INDENT = "    "; // components.schemas entry level
+
+function markerBounds(text: string): { begin: number; end: number } {
+  if (text.split(BEGIN).length !== 2 || text.split(END).length !== 2) {
+    throw new Error(`expected exactly one ${BEGIN} and one ${END} marker in ${OPENAPI_PATH}`);
+  }
+  const begin = text.indexOf("\n", text.indexOf(BEGIN)) + 1;
+  const end = text.lastIndexOf("\n", text.indexOf(END)) + 1;
+  if (begin > end) throw new Error("markers out of order");
+  return { begin, end };
+}
+
+// schema names defined outside the generated block
+function handWrittenNames(text: string, begin: number, end: number): Set<string> {
+  const outside = text.slice(0, begin) + text.slice(end);
+  const schemasSection = outside.match(/^ {2}schemas:\n([\s\S]*?)(?=^ {2}[a-zA-Z]|(?![\s\S]))/m);
+  if (!schemasSection) throw new Error("components.schemas section not found");
+  const names = new Set<string>();
+  for (const line of schemasSection[1].matchAll(/^ {4}([a-zA-Z0-9._-]+):/gm)) {
+    names.add(line[1]);
+  }
+  return names;
+}
+
+export async function spliceOpenapi(schemas: StateSchemas): Promise<boolean> {
+  const text = readFileSync(OPENAPI_PATH, "utf8");
+  const { begin, end } = markerBounds(text);
+
+  const existing = handWrittenNames(text, begin, end);
+  for (const name of Object.keys(schemas.defs)) {
+    if (existing.has(name)) {
+      throw new Error(`generated schema "${name}" collides with hand-written component`);
+    }
+  }
+
+  const block = stringify(schemas.defs, { lineWidth: 0, aliasDuplicateObjects: false })
+    .trimEnd()
+    .split("\n")
+    .map((line) => (line.length > 0 ? INDENT + line : line))
+    .join("\n");
+
+  const spliced = text.slice(0, begin) + block + "\n" + text.slice(end);
+
+  const config = await prettier.resolveConfig(OPENAPI_PATH);
+  const formatted = await prettier.format(spliced, { ...config, filepath: OPENAPI_PATH });
+
+  if (formatted === text) return false;
+  writeFileSync(OPENAPI_PATH, formatted);
+  return true;
+}
diff --git a/scripts/state-schema/schemas.ts b/scripts/state-schema/schemas.ts
new file mode 100644
index 00000000000..d4f7b640b98
--- /dev/null
+++ b/scripts/state-schema/schemas.ts
@@ -0,0 +1,182 @@
+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;
+}
+
+// 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));
+
+  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",
+  "enum",
+  "format",
+  "items",
+  "properties",
+  "required",
+  "additionalProperties",
+  "anyOf",
+];
+
+// 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 00000000000..a5be7e7ab7c
--- /dev/null
+++ b/scripts/state-schema/validate.ts
@@ -0,0 +1,93 @@
+import { readFileSync } from "node:fs";
+import { parse } from "yaml";
+import { Ajv2020 } from "ajv/dist/2020.js";
+
+const OPENAPI_PATH = "server/openapi.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}`);
+      }
+    }
+  }
+}
+
+// validate a /api/state payload against the State schema in server/openapi.yaml
+export function validateState(payload: any): { errors: string[]; undocumented: string[] } {
+  const doc = parse(readFileSync(OPENAPI_PATH, "utf8"));
+  const schemas: Record<string, AnySchema> = doc.components.schemas;
+
+  const ajv = new Ajv2020({ strict: false, allErrors: true });
+  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 f104c0ccb10..3ba8d8b2e12 100644
--- a/server/mcp/openapi.json
+++ b/server/mcp/openapi.json
@@ -110,7 +110,7 @@
         "name": "mode",
         "required": true,
         "schema": {
-          "$ref": "#/components/schemas/Mode"
+          "$ref": "#/components/schemas/ChargeMode"
         }
       },
       "phases": {
@@ -360,8 +360,161 @@
       }
     },
     "schemas": {
+      "AuthProviders": {
+        "additionalProperties": {
+          "properties": {
+            "authenticated": {
+              "type": "boolean"
+            },
+            "id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "authenticated"
+          ],
+          "type": "object"
+        },
+        "description": "Status of configured vehicle authentication providers, keyed by provider name.",
+        "type": "object"
+      },
+      "Battery": {
+        "description": "Home battery state. Aggregated across all battery meters.",
+        "properties": {
+          "capacity": {
+            "description": "Total battery capacity in kWh.",
+            "type": "number"
+          },
+          "devices": {
+            "description": "Measurement data per battery meter.",
+            "items": {
+              "$ref": "#/components/schemas/BatteryMeter"
+            },
+            "type": "array"
+          },
+          "energy": {
+            "description": "Total battery energy in kWh.",
+            "type": "number"
+          },
+          "forecast": {
+            "$ref": "#/components/schemas/BatteryForecast"
+          },
+          "power": {
+            "description": "Current battery power in W. Positive means discharging, negative means charging.",
+            "type": "number"
+          },
+          "soc": {
+            "description": "Charge level in %. Weighted by capacity across all batteries.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "power",
+          "capacity",
+          "soc"
+        ],
+        "type": "object"
+      },
+      "BatteryForecast": {
+        "description": "Projected home battery charge levels based on the solar and price forecast.",
+        "properties": {
+          "highest": {
+            "$ref": "#/components/schemas/BatteryForecastPoint"
+          },
+          "lowest": {
+            "$ref": "#/components/schemas/BatteryForecastPoint"
+          }
+        },
+        "type": "object"
+      },
+      "BatteryForecastPoint": {
+        "description": "A projected home battery charge level at a point in time.",
+        "properties": {
+          "limit": {
+            "description": "The projection hits the upper or lower battery limit.",
+            "type": "boolean"
+          },
+          "soc": {
+            "description": "Projected charge level in %.",
+            "type": "number"
+          },
+          "time": {
+            "description": "Time of the projected charge level.",
+            "format": "date-time",
+            "type": "string"
+          }
+        },
+        "required": [
+          "soc",
+          "time"
+        ],
+        "type": "object"
+      },
+      "BatteryMeter": {
+        "description": "Measurement data of a single home battery meter.",
+        "properties": {
+          "capacity": {
+            "description": "Battery capacity in kWh.",
+            "type": "number"
+          },
+          "controllable": {
+            "description": "Battery supports external control of its operation mode.",
+            "type": "boolean"
+          },
+          "currents": {
+            "description": "Current per phase in A.",
+            "items": {
+              "type": "number"
+            },
+            "type": "array"
+          },
+          "energy": {
+            "description": "Total energy in kWh.",
+            "type": "number"
+          },
+          "icon": {
+            "description": "Meter icon name for UI display.",
+            "type": "string"
+          },
+          "name": {
+            "description": "Unique device name of the meter.",
+            "type": "string"
+          },
+          "power": {
+            "description": "Current power in W.",
+            "type": "number"
+          },
+          "powers": {
+            "description": "Power per phase in W.",
+            "items": {
+              "type": "number"
+            },
+            "type": "array"
+          },
+          "returnEnergy": {
+            "description": "Total exported energy in kWh.",
+            "type": "number"
+          },
+          "soc": {
+            "description": "Charge level in %.",
+            "type": "number"
+          },
+          "title": {
+            "description": "Meter title for UI display.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "capacity",
+          "controllable",
+          "power",
+          "soc"
+        ],
+        "type": "object"
+      },
       "BatteryMode": {
-        "description": "Battery mode",
+        "description": "Battery operation mode.",
         "enum": [
           "unknown",
           "normal",
@@ -369,9 +522,26 @@
           "charge",
           "holdcharge"
         ],
-        "example": "normal",
         "type": "string"
       },
+      "Certificate": {
+        "description": "A TLS certificate key pair.",
+        "properties": {
+          "private": {
+            "description": "Private key in PEM format. Redacted.",
+            "type": "string"
+          },
+          "public": {
+            "description": "Public certificate in PEM format.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "public",
+          "private"
+        ],
+        "type": "object"
+      },
       "ChangePassword": {
         "properties": {
           "current": {
@@ -383,6 +553,25 @@
         },
         "type": "object"
       },
+      "ChargeMode": {
+        "description": "Charging mode.",
+        "enum": [
+          "off",
+          "now",
+          "minpv",
+          "pv"
+        ],
+        "type": "string"
+      },
+      "ChargerStatusReason": {
+        "description": "Reason why the charger is waiting.",
+        "enum": [
+          "unknown",
+          "waitingforauthorization",
+          "disconnectrequired"
+        ],
+        "type": "string"
+      },
       "ChargingSessions": {
         "description": "Charging sessions",
         "items": {
@@ -424,6 +613,71 @@
         },
         "type": "array"
       },
+      "Circuit": {
+        "description": "A load management circuit limiting power and current of its assigned loadpoints.",
+        "properties": {
+          "current": {
+            "description": "Current in A.",
+            "type": "number"
+          },
+          "icon": {
+            "description": "Circuit icon name for UI display.",
+            "type": "string"
+          },
+          "maxCurrent": {
+            "description": "Maximum allowed current in A.",
+            "type": "number"
+          },
+          "maxPower": {
+            "description": "Maximum allowed power in W.",
+            "type": "number"
+          },
+          "parent": {
+            "description": "Name of the parent circuit.",
+            "type": "string"
+          },
+          "power": {
+            "description": "Current power in W.",
+            "type": "number"
+          },
+          "title": {
+            "description": "Circuit title for UI display.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "power"
+        ],
+        "type": "object"
+      },
+      "Currency": {
+        "description": "Currency in ISO 4217 format.",
+        "enum": [
+          "AUD",
+          "BGN",
+          "BRL",
+          "CAD",
+          "CHF",
+          "CNY",
+          "CZK",
+          "EUR",
+          "GBP",
+          "HUF",
+          "ILS",
+          "JPY",
+          "NZD",
+          "NOK",
+          "PLN",
+          "RON",
+          "USD",
+          "DKK",
+          "SEK",
+          "ZAR",
+          "TRY",
+          "MYR"
+        ],
+        "type": "string"
+      },
       "Current": {
         "description": "Electric current in A",
         "example": 16,
@@ -435,12 +689,218 @@
         "example": 60,
         "type": "integer"
       },
+      "DeviceColorEntry": {
+        "description": "Color assigned to a device for consistent UI display.",
+        "properties": {
+          "color": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "title",
+          "color"
+        ],
+        "type": "object"
+      },
+      "Eebus": {
+        "description": "EEBus integration configuration and status.",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/EebusConfig"
+          },
+          "status": {
+            "$ref": "#/components/schemas/EebusStatus"
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "enum": [
+              "file",
+              "db"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "EebusConfig": {
+        "description": "EEBus integration configuration.",
+        "properties": {
+          "certificate": {
+            "$ref": "#/components/schemas/Certificate"
+          },
+          "interfaces": {
+            "description": "Network interfaces the EEBus service uses.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "port": {
+            "description": "Port the EEBus service listens on.",
+            "type": "number"
+          },
+          "shipid": {
+            "description": "SHIP id.",
+            "type": "string"
+          },
+          "uri": {
+            "description": "URI the EEBus service listens on.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "port",
+          "shipid"
+        ],
+        "type": "object"
+      },
+      "EebusStatus": {
+        "description": "EEBus runtime status.",
+        "properties": {
+          "qr": {
+            "description": "QR code payload for pairing.",
+            "type": "string"
+          },
+          "ski": {
+            "description": "SKI (subject key identifier) used for pairing.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "ski"
+        ],
+        "type": "object"
+      },
       "Energy": {
         "description": "Energy in kWh",
         "example": 25.5,
         "minimum": 0,
         "type": "number"
       },
+      "EnergyByDay": {
+        "description": "Expected solar production energy of a day.",
+        "properties": {
+          "complete": {
+            "description": "Forecast data covers the whole day.",
+            "type": "boolean"
+          },
+          "energy": {
+            "description": "Expected production energy in kWh.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "energy",
+          "complete"
+        ],
+        "type": "object"
+      },
+      "FatalError": {
+        "description": "A fatal startup error.",
+        "properties": {
+          "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"
+          },
+          "error": {
+            "description": "Error message.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "error"
+        ],
+        "type": "object"
+      },
+      "Forecast": {
+        "description": "Price, CO₂ and solar production forecasts.",
+        "properties": {
+          "co2": {
+            "description": "CO₂ emission forecast in g/kWh per time slot.",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            },
+            "type": "array"
+          },
+          "feedin": {
+            "description": "Feed-in rate forecast. Rate per kWh in the configured currency per time slot.",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            },
+            "type": "array"
+          },
+          "grid": {
+            "description": "Grid price forecast. Price per kWh in the configured currency per time slot.",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            },
+            "type": "array"
+          },
+          "planner": {
+            "description": "Charging cost forecast used by the plan optimizer per time slot.",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            },
+            "type": "array"
+          },
+          "solar": {
+            "$ref": "#/components/schemas/SolarDetails"
+          }
+        },
+        "type": "object"
+      },
+      "ForecastSlot": {
+        "description": "A forecast value for a time slot.",
+        "properties": {
+          "end": {
+            "description": "End of the time slot.",
+            "format": "date-time",
+            "type": "string"
+          },
+          "start": {
+            "description": "Start of the time slot.",
+            "format": "date-time",
+            "type": "string"
+          },
+          "value": {
+            "description": "Forecast value of the time slot. Unit depends on the forecast type.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "start",
+          "end",
+          "value"
+        ],
+        "type": "object"
+      },
+      "GenericConfigStatus": {
+        "description": "Configuration and runtime status of an integration. Structure depends on configuration.",
+        "properties": {
+          "config": {
+            "description": "Static configuration."
+          },
+          "status": {
+            "description": "Runtime status."
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "enum": [
+              "file",
+              "db"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
       "GridSessions": {
         "description": "Grid limitation sessions",
         "items": {
@@ -495,6 +955,61 @@
         },
         "type": "array"
       },
+      "Hems": {
+        "description": "Home energy management system integration.",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/HemsConfig"
+          },
+          "status": {
+            "$ref": "#/components/schemas/HemsStatus"
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "enum": [
+              "file",
+              "db"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "HemsConfig": {
+        "description": "Home energy management system configuration.",
+        "properties": {
+          "configured": {
+            "description": "A home energy management system is configured.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "configured"
+        ],
+        "type": "object"
+      },
+      "HemsStatus": {
+        "description": "Current external limits imposed by the home energy management system.",
+        "properties": {
+          "curtailed": {
+            "description": "Allowed feed-in in %. Values below 100 mean production is curtailed.",
+            "type": "number"
+          },
+          "dimmed": {
+            "description": "Consumption is currently limited.",
+            "type": "boolean"
+          },
+          "maxConsumptionPower": {
+            "description": "Maximum allowed consumption power in W.",
+            "type": "number"
+          },
+          "maxProductionPower": {
+            "description": "Maximum allowed production power in W.",
+            "type": "number"
+          }
+        },
+        "type": "object"
+      },
       "HourMinuteTime": {
         "description": "Time in `HH:MM` format",
         "example": "12:30",
@@ -516,22 +1031,587 @@
         "minimum": 1,
         "type": "integer"
       },
-      "LoadpointName": {
-        "example": "Garage",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/reference/configuration/loadpoints#title"
-        },
-        "type": "string"
-      },
-      "LogArea": {
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/reference/configuration/log#levels"
+      "InfluxConfig": {
+        "description": "InfluxDB integration configuration.",
+        "properties": {
+          "database": {
+            "description": "Database name (InfluxDB 1.x) or bucket (InfluxDB 2.x).",
+            "type": "string"
+          },
+          "insecure": {
+            "description": "Skip TLS certificate verification.",
+            "type": "boolean"
+          },
+          "org": {
+            "description": "Organization (InfluxDB 2.x).",
+            "type": "string"
+          },
+          "password": {
+            "description": "Password (InfluxDB 1.x). Redacted.",
+            "type": "string"
+          },
+          "token": {
+            "description": "Access token (InfluxDB 2.x). Redacted.",
+            "type": "string"
+          },
+          "url": {
+            "description": "InfluxDB server URL.",
+            "type": "string"
+          },
+          "user": {
+            "description": "Username (InfluxDB 1.x).",
+            "type": "string"
+          }
         },
-        "type": "string"
+        "required": [
+          "url",
+          "database",
+          "org"
+        ],
+        "type": "object"
       },
-      "LogAreas": {
-        "example": [
-          "lp-1",
+      "Loadpoint": {
+        "description": "A charging location with a charger, an optional dedicated meter and an optional vehicle.",
+        "properties": {
+          "batteryBoost": {
+            "description": "Battery boost is active. When enabled, home battery power is used for fast charging.",
+            "type": "boolean"
+          },
+          "batteryBoostLimit": {
+            "description": "SoC limit for battery boost in %.",
+            "type": "number"
+          },
+          "chargeCurrents": {
+            "description": "Charging current per phase in A.",
+            "items": {
+              "type": "number"
+            },
+            "type": "array"
+          },
+          "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.",
+            "items": {
+              "type": "number"
+            },
+            "type": "array"
+          },
+          "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",
+              "null"
+            ]
+          },
+          "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": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ChargerStatusReason"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Reason why the charger is waiting, like a pending authorization or a required disconnect."
+          },
+          "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"
+          },
+          "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"
+          },
+          "effectivePlanStrategy": {
+            "$ref": "#/components/schemas/PlanStrategy"
+          },
+          "effectivePlanTime": {
+            "description": "Target time of the currently applied charging plan.",
+            "format": "date-time",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "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"
+          },
+          "minSocNotReached": {
+            "description": "Vehicle SoC is below the configured minimum SoC.",
+            "type": "boolean"
+          },
+          "mode": {
+            "$ref": "#/components/schemas/ChargeMode"
+          },
+          "name": {
+            "description": "Unique loadpoint identifier used in API routes and configuration.",
+            "type": "string"
+          },
+          "offeredCurrent": {
+            "description": "Current offered to the vehicle in A.",
+            "type": "number"
+          },
+          "phaseAction": {
+            "$ref": "#/components/schemas/PhaseAction"
+          },
+          "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": {
+            "anyOf": [
+              {
+                "items": {
+                  "$ref": "#/components/schemas/Rate"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Time slots of the current charging plan."
+          },
+          "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"
+          },
+          "planProjectedEnd": {
+            "description": "Projected end of the charging plan. End of the last planned slot.",
+            "format": "date-time",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "planProjectedStart": {
+            "description": "Projected start of the charging plan. Start of the earliest planned slot.",
+            "format": "date-time",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "planStrategy": {
+            "$ref": "#/components/schemas/PlanStrategy"
+          },
+          "planTime": {
+            "description": "Target time of the charging plan.",
+            "format": "date-time",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "priority": {
+            "description": "Priority for surplus distribution. Higher number means higher priority.",
+            "type": "number"
+          },
+          "pvAction": {
+            "$ref": "#/components/schemas/PvAction"
+          },
+          "pvRemaining": {
+            "description": "Remaining time until the pending charge start or stop action executes, in seconds.",
+            "type": "number"
+          },
+          "sessionCo2PerKWh": {
+            "description": "Average CO₂ emissions of the current charging session in g/kWh.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "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",
+              "null"
+            ]
+          },
+          "sessionPricePerKWh": {
+            "description": "Average energy price of the current charging session per kWh in the configured currency.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "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",
+              "null"
+            ]
+          },
+          "smartCostNextStart": {
+            "description": "Start of the next fast charging period with cheap or clean grid energy.",
+            "format": "date-time",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "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",
+              "null"
+            ]
+          },
+          "smartFeedInPriorityNextStart": {
+            "description": "Start of the next charging pause for prioritized feed-in.",
+            "format": "date-time",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "title": {
+            "description": "Loadpoint title for UI display.",
+            "type": "string"
+          },
+          "ui": {
+            "$ref": "#/components/schemas/LoadpointUi"
+          },
+          "vehicleClimaterActive": {
+            "description": "Climater of the connected vehicle is active.",
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "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"
+          }
+        },
+        "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",
+          "effectivePlanId",
+          "effectivePlanSoc",
+          "effectivePlanTime",
+          "effectivePlanStrategy",
+          "effectivePriority",
+          "enableDelay",
+          "enableThreshold",
+          "enabled",
+          "limitEnergy",
+          "limitSoc",
+          "maxCurrent",
+          "minCurrent",
+          "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"
+        ],
+        "type": "object"
+      },
+      "LoadpointName": {
+        "example": "Garage",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/reference/configuration/loadpoints#title"
+        },
+        "type": "string"
+      },
+      "LoadpointUi": {
+        "description": "Display-only UI settings of a loadpoint.",
+        "properties": {
+          "maxTemp": {
+            "description": "Upper bound of the temperature scale for heating devices, in degrees.",
+            "type": "number"
+          },
+          "minTemp": {
+            "description": "Lower bound of the temperature scale for heating devices, in degrees.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "minTemp",
+          "maxTemp"
+        ],
+        "type": "object"
+      },
+      "LogArea": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/reference/configuration/log#levels"
+        },
+        "type": "string"
+      },
+      "LogAreas": {
+        "example": [
+          "lp-1",
           "site",
           "db"
         ],
@@ -558,16 +1638,440 @@
         },
         "type": "string"
       },
-      "Mode": {
-        "description": "Charging mode.",
+      "MessagingEvent": {
+        "description": "A configured notification message.",
+        "properties": {
+          "disabled": {
+            "description": "Notifications for this event are disabled.",
+            "type": "boolean"
+          },
+          "msg": {
+            "description": "Message body template.",
+            "type": "string"
+          },
+          "title": {
+            "description": "Message title template.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "title",
+          "msg",
+          "disabled"
+        ],
+        "type": "object"
+      },
+      "MessagingEvents": {
+        "additionalProperties": false,
+        "description": "Configured notification messages, keyed by event type.",
+        "properties": {
+          "asleep": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "connect": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "disconnect": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "guest": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "planoverrun": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "soc": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "start": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          },
+          "stop": {
+            "$ref": "#/components/schemas/MessagingEvent"
+          }
+        },
+        "required": [
+          "start",
+          "stop",
+          "connect",
+          "disconnect",
+          "soc",
+          "guest",
+          "asleep",
+          "planoverrun"
+        ],
+        "type": "object"
+      },
+      "Meter": {
+        "description": "Measurement data of a single meter.",
+        "properties": {
+          "currents": {
+            "description": "Current per phase in A.",
+            "items": {
+              "type": "number"
+            },
+            "type": "array"
+          },
+          "energy": {
+            "description": "Total energy in kWh.",
+            "type": "number"
+          },
+          "icon": {
+            "description": "Meter icon name for UI display.",
+            "type": "string"
+          },
+          "name": {
+            "description": "Unique device name of the meter.",
+            "type": "string"
+          },
+          "power": {
+            "description": "Current power in W.",
+            "type": "number"
+          },
+          "powers": {
+            "description": "Power per phase in W.",
+            "items": {
+              "type": "number"
+            },
+            "type": "array"
+          },
+          "returnEnergy": {
+            "description": "Total exported energy in kWh.",
+            "type": "number"
+          },
+          "title": {
+            "description": "Meter title for UI display.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "power"
+        ],
+        "type": "object"
+      },
+      "ModbusBaudrate": {
+        "description": "Serial baud rate.",
         "enum": [
-          "off",
-          "now",
-          "minpv",
-          "pv"
+          1200,
+          9600,
+          19200,
+          38400,
+          57600,
+          115200
+        ],
+        "type": "number"
+      },
+      "ModbusComset": {
+        "description": "Serial communication parameters.",
+        "enum": [
+          "8N1",
+          "8E1",
+          "8N2"
+        ],
+        "type": "string"
+      },
+      "ModbusProxy": {
+        "description": "A Modbus proxy forwarding requests to a physical device.",
+        "properties": {
+          "port": {
+            "description": "Port the proxy listens on.",
+            "type": "number"
+          },
+          "readonly": {
+            "$ref": "#/components/schemas/ModbusProxyReadonly"
+          },
+          "settings": {
+            "$ref": "#/components/schemas/ModbusProxySettings"
+          }
+        },
+        "required": [
+          "port",
+          "readonly",
+          "settings"
+        ],
+        "type": "object"
+      },
+      "ModbusProxyReadonly": {
+        "description": "How the Modbus proxy handles write requests.",
+        "enum": [
+          "false",
+          "true",
+          "deny"
         ],
         "type": "string"
       },
+      "ModbusProxySettings": {
+        "description": "Connection settings of a Modbus device.",
+        "properties": {
+          "baudrate": {
+            "$ref": "#/components/schemas/ModbusBaudrate"
+          },
+          "comset": {
+            "$ref": "#/components/schemas/ModbusComset"
+          },
+          "device": {
+            "description": "Serial device path.",
+            "type": "string"
+          },
+          "rtu": {
+            "description": "Use RTU protocol over TCP.",
+            "type": "boolean"
+          },
+          "uri": {
+            "description": "Device address for TCP connections.",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "MqttConfig": {
+        "description": "MQTT integration configuration.",
+        "properties": {
+          "broker": {
+            "description": "Broker address.",
+            "type": "string"
+          },
+          "caCert": {
+            "description": "CA certificate for TLS connections.",
+            "type": "string"
+          },
+          "clientCert": {
+            "description": "Client certificate for TLS connections.",
+            "type": "string"
+          },
+          "clientID": {
+            "description": "MQTT client id.",
+            "type": "string"
+          },
+          "clientKey": {
+            "description": "Client key for TLS connections.",
+            "type": "string"
+          },
+          "insecure": {
+            "description": "Skip TLS certificate verification.",
+            "type": "boolean"
+          },
+          "password": {
+            "description": "Broker password. Redacted.",
+            "type": "string"
+          },
+          "topic": {
+            "description": "Root topic all values are published under.",
+            "type": "string"
+          },
+          "user": {
+            "description": "Broker username.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "broker",
+          "topic"
+        ],
+        "type": "object"
+      },
+      "Network": {
+        "description": "Network configuration.",
+        "properties": {
+          "externalUrl": {
+            "description": "Externally reachable URL.",
+            "type": "string"
+          },
+          "host": {
+            "description": "Hostname.",
+            "type": "string"
+          },
+          "internalUrl": {
+            "description": "URL in the local network.",
+            "type": "string"
+          },
+          "port": {
+            "description": "HTTP port.",
+            "type": "number"
+          },
+          "schema": {
+            "description": "URL schema, http or https.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "host",
+          "port"
+        ],
+        "type": "object"
+      },
+      "Ocpp": {
+        "description": "OCPP server configuration and status.",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/OcppConfig"
+          },
+          "status": {
+            "$ref": "#/components/schemas/OcppStatus"
+          }
+        },
+        "required": [
+          "config",
+          "status"
+        ],
+        "type": "object"
+      },
+      "OcppConfig": {
+        "description": "OCPP server configuration.",
+        "properties": {
+          "port": {
+            "description": "Port the OCPP server listens on.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "port"
+        ],
+        "type": "object"
+      },
+      "OcppConnectionStatus": {
+        "description": "Connection status of an OCPP station.",
+        "enum": [
+          "unknown",
+          "configured",
+          "connected"
+        ],
+        "type": "string"
+      },
+      "OcppForwarder": {
+        "description": "OCPP forwarder rules and upstream connection status.",
+        "properties": {
+          "config": {
+            "description": "Static configuration.",
+            "items": {
+              "$ref": "#/components/schemas/OcppForwarderRule"
+            },
+            "type": "array"
+          },
+          "status": {
+            "description": "Runtime status.",
+            "items": {
+              "$ref": "#/components/schemas/OcppForwarderSession"
+            },
+            "type": "array"
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "enum": [
+              "file",
+              "db"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "OcppForwarderRule": {
+        "description": "A rule forwarding an OCPP station to an upstream backend.",
+        "properties": {
+          "caCert": {
+            "description": "CA certificate for TLS connections.",
+            "type": "string"
+          },
+          "insecure": {
+            "description": "Skip TLS certificate verification.",
+            "type": "boolean"
+          },
+          "password": {
+            "description": "Password for upstream authentication. Redacted.",
+            "type": "string"
+          },
+          "readOnly": {
+            "description": "Only forward read operations to the station.",
+            "type": "boolean"
+          },
+          "stationId": {
+            "description": "Station id to forward.",
+            "type": "string"
+          },
+          "upstreamStationId": {
+            "description": "Station id used towards the upstream backend.",
+            "type": "string"
+          },
+          "upstreamUrl": {
+            "description": "URL of the upstream OCPP backend.",
+            "type": "string"
+          },
+          "username": {
+            "description": "Username for upstream authentication.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "stationId",
+          "upstreamUrl"
+        ],
+        "type": "object"
+      },
+      "OcppForwarderSession": {
+        "description": "Connection status of an OCPP forwarder rule.",
+        "properties": {
+          "chargerId": {
+            "description": "Charger id.",
+            "type": "string"
+          },
+          "error": {
+            "description": "Last connection error.",
+            "type": "string"
+          },
+          "upstreamConnected": {
+            "description": "Connection to the upstream backend is established.",
+            "type": "boolean"
+          },
+          "upstreamUrl": {
+            "description": "URL of the upstream OCPP backend.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "chargerId",
+          "upstreamUrl",
+          "upstreamConnected"
+        ],
+        "type": "object"
+      },
+      "OcppStationStatus": {
+        "description": "Connection status of an OCPP station.",
+        "properties": {
+          "id": {
+            "description": "Station id.",
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/components/schemas/OcppConnectionStatus"
+          }
+        },
+        "required": [
+          "id",
+          "status"
+        ],
+        "type": "object"
+      },
+      "OcppStatus": {
+        "description": "OCPP server status.",
+        "properties": {
+          "externalUrl": {
+            "description": "Externally reachable URL of the OCPP server.",
+            "type": "string"
+          },
+          "stations": {
+            "description": "Connection status per configured station.",
+            "items": {
+              "$ref": "#/components/schemas/OcppStationStatus"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "stations"
+        ],
+        "type": "object"
+      },
       "Odometer": {
         "description": "Vehicle odometer reading in kilometers",
         "nullable": true,
@@ -577,6 +2081,15 @@
         "description": "Admin password",
         "type": "string"
       },
+      "PhaseAction": {
+        "description": "Pending phase switching action in solar mode.",
+        "enum": [
+          "inactive",
+          "scale1p",
+          "scale3p"
+        ],
+        "type": "string"
+      },
       "Phases": {
         "description": "Number of phases. (0: auto, 1: 1-phase, 3: 3-phase)",
         "enum": [
@@ -607,18 +2120,21 @@
         "type": "object"
       },
       "PlanStrategy": {
-        "description": "Charging plan strategy configuration",
+        "description": "Charging plan strategy.",
         "properties": {
           "continuous": {
-            "description": "Force continuous planning",
+            "description": "Force continuous charging without gaps.",
             "type": "boolean"
           },
           "precondition": {
-            "description": "Precondition duration in seconds",
-            "minimum": 0,
-            "type": "integer"
+            "description": "Duration of uninterrupted charging directly before the target time, in seconds.",
+            "type": "number"
           }
         },
+        "required": [
+          "continuous",
+          "precondition"
+        ],
         "type": "object"
       },
       "Power": {
@@ -633,21 +2149,38 @@
         "minimum": 0,
         "type": "integer"
       },
+      "PvAction": {
+        "description": "Pending charge start or stop action in solar mode.",
+        "enum": [
+          "inactive",
+          "enable",
+          "disable"
+        ],
+        "type": "string"
+      },
       "Rate": {
-        "description": "A charging interval",
+        "description": "A time slot with an associated price or emission value.",
         "properties": {
           "end": {
-            "$ref": "#/components/schemas/Timestamp"
+            "description": "End of the time slot.",
+            "format": "date-time",
+            "type": "string"
           },
           "start": {
-            "$ref": "#/components/schemas/Timestamp"
+            "description": "Start of the time slot.",
+            "format": "date-time",
+            "type": "string"
           },
           "value": {
-            "description": "Cost",
-            "minimum": 0,
+            "description": "Price per kWh in the configured currency or emissions in g/kWh.",
             "type": "number"
           }
         },
+        "required": [
+          "start",
+          "end",
+          "value"
+        ],
         "type": "object"
       },
       "Rates": {
@@ -656,30 +2189,135 @@
         },
         "type": "array"
       },
+      "Remote": {
+        "description": "Remote access configuration and connection status.",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/RemoteConfig"
+          },
+          "status": {
+            "$ref": "#/components/schemas/RemoteStatus"
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "enum": [
+              "file",
+              "db"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "RemoteConfig": {
+        "description": "Remote access configuration.",
+        "properties": {
+          "enabled": {
+            "description": "Remote access is enabled.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "enabled"
+        ],
+        "type": "object"
+      },
+      "RemoteStatus": {
+        "description": "Remote access connection status.",
+        "properties": {
+          "connected": {
+            "description": "Connection to the remote access server is established.",
+            "type": "boolean"
+          },
+          "lastSeen": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Last remote activity per client, keyed by username. RFC3339 timestamps.",
+            "type": "object"
+          },
+          "loginBlocked": {
+            "description": "Remote login attempts are currently blocked by the rate limiter.",
+            "type": "boolean"
+          },
+          "url": {
+            "description": "Remote access URL.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "connected",
+          "loginBlocked"
+        ],
+        "type": "object"
+      },
       "RepeatingPlan": {
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/plans#repeating-plans"
-        },
+        "description": "A repeating charging plan.",
         "properties": {
           "active": {
-            "description": "Set plan active.",
+            "description": "Plan is active.",
             "type": "boolean"
           },
           "soc": {
-            "$ref": "#/components/schemas/Soc"
+            "description": "SoC goal in %.",
+            "type": "number"
           },
           "time": {
-            "$ref": "#/components/schemas/HourMinuteTime"
+            "description": "Target time in HH:MM format.",
+            "type": "string"
           },
           "tz": {
-            "$ref": "#/components/schemas/IANATimeZone"
+            "description": "Time zone of the target time, like Europe/Berlin.",
+            "type": "string"
           },
           "weekdays": {
-            "$ref": "#/components/schemas/Weekdays"
+            "description": "Weekdays the plan is active. 0 is Sunday, 6 is Saturday.",
+            "items": {
+              "type": "number"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "weekdays",
+          "time",
+          "tz",
+          "soc",
+          "active"
+        ],
+        "type": "object"
+      },
+      "ShmConfig": {
+        "description": "SMA Home Manager configuration.",
+        "properties": {
+          "deviceId": {
+            "description": "SMA device id.",
+            "type": "string"
+          },
+          "deviceSerial": {
+            "description": "SMA device serial.",
+            "type": "string"
+          },
+          "vendorId": {
+            "description": "SMA vendor id.",
+            "type": "string"
           }
         },
+        "required": [
+          "vendorId",
+          "deviceId"
+        ],
         "type": "object"
       },
+      "SmartCostType": {
+        "description": "Type of the smart charging limit.",
+        "enum": [
+          "co2",
+          "pricedynamic",
+          "priceforecast"
+        ],
+        "type": "string"
+      },
       "Soc": {
         "description": "SOC in %",
         "example": 60,
@@ -687,36 +2325,541 @@
         "minimum": 0,
         "type": "number"
       },
+      "SolarDetails": {
+        "description": "Solar production forecast.",
+        "properties": {
+          "dayAfterTomorrow": {
+            "$ref": "#/components/schemas/EnergyByDay"
+          },
+          "scale": {
+            "description": "Correction factor applied to the forecast based on past production.",
+            "type": "number"
+          },
+          "timeseries": {
+            "description": "Expected production power over time.",
+            "items": {
+              "$ref": "#/components/schemas/TimeseriesEntry"
+            },
+            "type": "array"
+          },
+          "today": {
+            "$ref": "#/components/schemas/EnergyByDay"
+          },
+          "tomorrow": {
+            "$ref": "#/components/schemas/EnergyByDay"
+          }
+        },
+        "type": "object"
+      },
+      "Sponsor": {
+        "description": "Sponsorship status.",
+        "properties": {
+          "config": {
+            "description": "Static configuration."
+          },
+          "status": {
+            "$ref": "#/components/schemas/SponsorStatus"
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "enum": [
+              "file",
+              "db"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "SponsorStatus": {
+        "description": "Sponsorship status.",
+        "properties": {
+          "expiresAt": {
+            "description": "Expiry time of the sponsor token.",
+            "format": "date-time",
+            "type": "string"
+          },
+          "expiresSoon": {
+            "description": "Sponsor token expires soon.",
+            "type": "boolean"
+          },
+          "name": {
+            "description": "Name of the sponsor.",
+            "type": "string"
+          },
+          "token": {
+            "description": "Sponsor token. Redacted.",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
       "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.",
+        "description": "Complete system state as returned by /api/state and pushed via websocket and MQTT. The overall structure is stable, details may change between releases.",
+        "properties": {
+          "apiReady": {
+            "description": "HTTP API is ready to accept requests.",
+            "type": "boolean"
+          },
+          "authDisabled": {
+            "description": "Authentication is disabled.",
+            "type": "boolean"
+          },
+          "authProviders": {
+            "$ref": "#/components/schemas/AuthProviders"
+          },
+          "aux": {
+            "description": "Auxiliary consumption meters. Their power is treated as available for charging.",
+            "items": {
+              "$ref": "#/components/schemas/Meter"
+            },
+            "type": "array"
+          },
+          "auxPower": {
+            "description": "Total power of all auxiliary meters in W.",
+            "type": "number"
+          },
+          "availableVersion": {
+            "description": "Latest available evcc version.",
+            "type": "string"
+          },
+          "battery": {
+            "$ref": "#/components/schemas/Battery"
+          },
+          "batteryDischargeControl": {
+            "description": "Home battery discharge is prevented during fast charging and planned charging.",
+            "type": "boolean"
+          },
+          "batteryGridChargeActive": {
+            "description": "Home battery is currently charged from grid.",
+            "type": "boolean"
+          },
+          "batteryGridChargeLimit": {
+            "description": "Price or emission limit for charging the home battery from grid.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "batteryMode": {
+            "$ref": "#/components/schemas/BatteryMode"
+          },
+          "bufferSoc": {
+            "description": "Battery buffer SoC in %. Energy above this level may be used for charging in solar mode.",
+            "type": "number"
+          },
+          "bufferStartSoc": {
+            "description": "Battery buffer start SoC in %. Solar charging starts automatically above this level.",
+            "type": "number"
+          },
+          "circuits": {
+            "additionalProperties": {
+              "$ref": "#/components/schemas/Circuit"
+            },
+            "description": "Load management circuits, keyed by circuit name.",
+            "type": "object"
+          },
+          "config": {
+            "description": "Path of the evcc configuration file.",
+            "type": "string"
+          },
+          "consumers": {
+            "description": "Consumption meters of individual devices for monitoring purposes.",
+            "items": {
+              "$ref": "#/components/schemas/Meter"
+            },
+            "type": "array"
+          },
+          "currency": {
+            "$ref": "#/components/schemas/Currency"
+          },
+          "database": {
+            "description": "Path of the evcc database.",
+            "type": "string"
+          },
+          "demoMode": {
+            "description": "Instance runs in demo mode.",
+            "type": "boolean"
+          },
+          "deviceColors": {
+            "description": "Colors assigned to devices for consistent UI display.",
+            "items": {
+              "$ref": "#/components/schemas/DeviceColorEntry"
+            },
+            "type": "array"
+          },
+          "eebus": {
+            "$ref": "#/components/schemas/Eebus"
+          },
+          "experimental": {
+            "description": "Experimental UI features are enabled.",
+            "type": "boolean"
+          },
+          "ext": {
+            "description": "Additional meters for monitoring purposes.",
+            "items": {
+              "$ref": "#/components/schemas/Meter"
+            },
+            "type": "array"
+          },
+          "fatal": {
+            "description": "Fatal startup errors.",
+            "items": {
+              "$ref": "#/components/schemas/FatalError"
+            },
+            "type": "array"
+          },
+          "forecast": {
+            "$ref": "#/components/schemas/Forecast"
+          },
+          "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"
+          },
+          "grid": {
+            "$ref": "#/components/schemas/Meter"
+          },
+          "gridConfigured": {
+            "description": "A grid meter is configured.",
+            "type": "boolean"
+          },
+          "hems": {
+            "$ref": "#/components/schemas/Hems"
+          },
+          "historyUpdated": {
+            "description": "Time of the last energy history update.",
+            "format": "date-time",
+            "type": "string"
+          },
+          "homePower": {
+            "description": "Home consumption power in W.",
+            "type": "number"
+          },
+          "influx": {
+            "$ref": "#/components/schemas/InfluxConfig"
+          },
+          "interval": {
+            "description": "Update interval of the control loop in seconds.",
+            "type": "number"
+          },
+          "loadpoints": {
+            "description": "Charging locations. One entry per configured loadpoint.",
+            "items": {
+              "$ref": "#/components/schemas/Loadpoint"
+            },
+            "type": "array"
+          },
+          "mcp": {
+            "description": "Built-in MCP server is enabled.",
+            "type": "boolean"
+          },
+          "messaging": {
+            "$ref": "#/components/schemas/GenericConfigStatus"
+          },
+          "messagingEvents": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/MessagingEvents"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Configured notification messages per event type."
+          },
+          "modbusproxy": {
+            "anyOf": [
+              {
+                "items": {
+                  "$ref": "#/components/schemas/ModbusProxy"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Modbus proxy configuration."
+          },
+          "mqtt": {
+            "$ref": "#/components/schemas/MqttConfig"
+          },
+          "network": {
+            "$ref": "#/components/schemas/Network"
+          },
+          "ocpp": {
+            "$ref": "#/components/schemas/Ocpp"
+          },
+          "ocppforwarder": {
+            "$ref": "#/components/schemas/OcppForwarder"
+          },
+          "optimizer": {
+            "description": "Battery optimizer is enabled.",
+            "type": "boolean"
+          },
+          "optimizerChargingStrategies": {
+            "description": "Available battery optimizer charging strategies.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "optimizerChargingStrategy": {
+            "description": "Selected battery optimizer charging strategy.",
+            "type": "string"
+          },
+          "prioritySoc": {
+            "description": "Battery priority SoC in %. Home battery is charged first while below this level.",
+            "type": "number"
+          },
+          "pv": {
+            "description": "Solar generation meters. One entry per configured pv meter.",
+            "items": {
+              "$ref": "#/components/schemas/Meter"
+            },
+            "type": "array"
+          },
+          "pvEnergy": {
+            "description": "Total solar generation energy in kWh.",
+            "type": "number"
+          },
+          "pvPower": {
+            "description": "Total solar generation power in W. Sum of all pv meters.",
+            "type": "number"
+          },
+          "remote": {
+            "$ref": "#/components/schemas/Remote"
+          },
+          "residualPower": {
+            "description": "Configured grid operating point in W. Positive values maintain grid import.",
+            "type": "number"
+          },
+          "setupRequired": {
+            "description": "Initial setup is required.",
+            "type": "boolean"
+          },
+          "shm": {
+            "$ref": "#/components/schemas/ShmConfig"
+          },
+          "siteTitle": {
+            "description": "Configured site title.",
+            "type": "string"
+          },
+          "smartCostAvailable": {
+            "description": "A dynamic grid price or CO₂ forecast is configured.",
+            "type": "boolean"
+          },
+          "smartCostType": {
+            "$ref": "#/components/schemas/SmartCostType"
+          },
+          "smartFeedInPriorityAvailable": {
+            "description": "A feed-in tariff with forecast is configured.",
+            "type": "boolean"
+          },
+          "sponsor": {
+            "$ref": "#/components/schemas/Sponsor"
+          },
+          "startupCompleted": {
+            "description": "Startup has completed.",
+            "type": "boolean"
+          },
+          "statistics": {
+            "$ref": "#/components/schemas/Statistics"
+          },
+          "system": {
+            "description": "Operating system and architecture.",
+            "examples": [
+              "linux/amd64"
+            ],
+            "type": "string"
+          },
+          "tariffCo2": {
+            "description": "Current grid CO₂ emissions in g/kWh.",
+            "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"
+          },
+          "tariffFeedIn": {
+            "description": "Current feed-in rate per kWh in the configured currency.",
+            "type": "number"
+          },
+          "tariffGrid": {
+            "description": "Current grid energy price 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"
+          },
+          "tariffSolar": {
+            "description": "Current cost of solar generation per kWh in the configured currency.",
+            "type": "number"
+          },
+          "tariffs": {
+            "$ref": "#/components/schemas/GenericConfigStatus"
+          },
+          "telemetry": {
+            "description": "Telemetry is enabled.",
+            "type": "boolean"
+          },
+          "timezone": {
+            "description": "Server time zone abbreviation and UTC offset.",
+            "examples": [
+              "CEST +02:00"
+            ],
+            "type": "string"
+          },
+          "vehicles": {
+            "additionalProperties": {
+              "$ref": "#/components/schemas/Vehicle"
+            },
+            "description": "Configured vehicles, keyed by vehicle name.",
+            "type": "object"
+          },
+          "version": {
+            "description": "Running evcc version.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "loadpoints",
+          "forecast",
+          "vehicles"
+        ],
         "type": "object"
       },
       "StaticEnergyPlan": {
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/plans#energy-amount-plan"
-        },
+        "description": "Charging plan with an energy goal.",
         "properties": {
           "energy": {
-            "$ref": "#/components/schemas/Energy"
+            "description": "Energy goal in kWh.",
+            "type": "number"
           },
           "time": {
-            "$ref": "#/components/schemas/Timestamp"
+            "description": "Target time.",
+            "format": "date-time",
+            "type": "string"
           }
         },
+        "required": [
+          "energy",
+          "time"
+        ],
         "type": "object"
       },
+      "StaticPlan": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/StaticSocPlan"
+          },
+          {
+            "$ref": "#/components/schemas/StaticEnergyPlan"
+          }
+        ],
+        "description": "Charging plan with a fixed target time and a SoC or energy goal."
+      },
       "StaticSocPlan": {
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/plans#create-charging-plan"
-        },
+        "description": "Charging plan with a SoC goal.",
         "properties": {
           "soc": {
-            "$ref": "#/components/schemas/Soc"
+            "description": "SoC goal in %.",
+            "type": "number"
           },
           "time": {
-            "$ref": "#/components/schemas/Timestamp"
+            "description": "Target time.",
+            "format": "date-time",
+            "type": "string"
+          }
+        },
+        "required": [
+          "soc",
+          "time"
+        ],
+        "type": "object"
+      },
+      "Statistics": {
+        "description": "Charging statistics, keyed by time period.",
+        "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"
+        ],
+        "type": "object"
+      },
+      "StatisticsData": {
+        "description": "Aggregated charging statistics for a time period.",
+        "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"
+        ],
+        "type": "object"
+      },
+      "TimeseriesEntry": {
+        "description": "A forecast value at a point in time.",
+        "properties": {
+          "ts": {
+            "description": "Time of the forecast value.",
+            "format": "date-time",
+            "type": "string"
+          },
+          "val": {
+            "description": "Forecast power in W.",
+            "type": "number"
           }
         },
+        "required": [
+          "val",
+          "ts"
+        ],
         "type": "object"
       },
       "Timestamp": {
@@ -724,6 +2867,68 @@
         "format": "date-time",
         "type": "string"
       },
+      "Vehicle": {
+        "description": "A configured vehicle.",
+        "properties": {
+          "capacity": {
+            "description": "Usable battery capacity in kWh.",
+            "type": "number"
+          },
+          "features": {
+            "description": "Feature flags of the vehicle implementation.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "icon": {
+            "description": "Vehicle icon name for UI display.",
+            "type": "string"
+          },
+          "limitSoc": {
+            "description": "SoC limit in %. Charging stops when reached.",
+            "type": "number"
+          },
+          "minSoc": {
+            "description": "Minimum SoC in %. Vehicle is fast-charged until this level is reached.",
+            "type": "number"
+          },
+          "name": {
+            "description": "Unique vehicle name used in API routes and configuration.",
+            "type": "string"
+          },
+          "plan": {
+            "$ref": "#/components/schemas/StaticPlan"
+          },
+          "planStrategy": {
+            "$ref": "#/components/schemas/PlanStrategy"
+          },
+          "repeatingPlans": {
+            "anyOf": [
+              {
+                "items": {
+                  "$ref": "#/components/schemas/RepeatingPlan"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Repeating charging plans."
+          },
+          "title": {
+            "description": "Vehicle title for UI display.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "repeatingPlans",
+          "planStrategy",
+          "title"
+        ],
+        "type": "object"
+      },
       "VehicleName": {
         "example": "vehicle_1",
         "externalDocs": {
@@ -1749,7 +3954,7 @@
                 "schema": {
                   "properties": {
                     "result": {
-                      "$ref": "#/components/schemas/Mode"
+                      "$ref": "#/components/schemas/ChargeMode"
                     }
                   },
                   "type": "object"
@@ -2539,10 +4744,7 @@
     },
     "/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/en/docs/reference/configuration/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.",
         "operationId": "getState",
         "parameters": [
           {
@@ -2569,12 +4771,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "properties": {
-                    "result": {
-                      "$ref": "#/components/schemas/State"
-                    }
-                  },
-                  "type": "object"
+                  "$ref": "#/components/schemas/State"
                 }
               }
             },
diff --git a/server/mcp/openapi.md b/server/mcp/openapi.md
index eadfa6a994e..fe839ce18b2 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"
 }
 ```
 
@@ -346,7 +346,7 @@ call getEnergyHistory {
 
 ## 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.
+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.
 
 **Tags:** general
 
diff --git a/server/openapi.yaml b/server/openapi.yaml
index 2563cbb22ca..ef3355297a6 100644
--- a/server/openapi.yaml
+++ b/server/openapi.yaml
@@ -423,7 +423,7 @@ paths:
                 type: object
                 properties:
                   result:
-                    $ref: "#/components/schemas/Mode"
+                    $ref: "#/components/schemas/ChargeMode"
   /loadpoints/{id}/phases/{phases}:
     post:
       operationId: setLoadpointPhases
@@ -927,9 +927,7 @@ paths:
     get:
       operationId: getState
       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."
-      externalDocs:
-        url: https://docs.evcc.io/en/docs/reference/configuration/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."
       tags:
         - general
       parameters:
@@ -951,10 +949,7 @@ paths:
           content:
             application/json:
               schema:
-                type: object
-                properties:
-                  result:
-                    $ref: "#/components/schemas/State"
+                $ref: "#/components/schemas/State"
   /system/log:
     get:
       operationId: getSystemLogs
@@ -1398,16 +1393,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:
@@ -1545,14 +1530,6 @@ components:
         - INFO
         - DEBUG
         - TRACE
-    Mode:
-      description: "Charging mode."
-      type: string
-      enum:
-        - "off"
-        - "now"
-        - "minpv"
-        - "pv"
     Odometer:
       nullable: true
       type: "number"
@@ -1591,78 +1568,1764 @@ components:
       type: integer
       example: 3600
       minimum: 0
-    Rate:
+    Rates:
+      type: array
+      items:
+        $ref: "#/components/schemas/Rate"
+    Soc:
+      description: SOC in %
+      type: number
+      example: 60
+      minimum: 0
+      maximum: 100
+    # GENERATED_STATE_SCHEMAS_BEGIN (source: assets/js/types/evcc.ts, update: npm run openapi)
+    State:
+      description: Complete system state as returned by /api/state and pushed via websocket and MQTT. The overall structure is stable, details may change 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
+          examples:
+            - linux/amd64
+        timezone:
+          description: Server time zone abbreviation and UTC offset.
+          type: string
+          examples:
+            - 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
+        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.
+          anyOf:
+            - type: array
+              items:
+                $ref: "#/components/schemas/ModbusProxy"
+            - type: "null"
+        messaging:
+          $ref: "#/components/schemas/GenericConfigStatus"
+          description: Messaging services configuration. Structure depends on configuration.
+        messagingEvents:
+          description: Configured notification messages per event type.
+          anyOf:
+            - $ref: "#/components/schemas/MessagingEvents"
+            - type: "null"
+        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
+        batteryGridChargeLimit:
+          description: Price or emission limit for charging the home battery from grid.
+          type:
+            - number
+            - "null"
+        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.
+          type: number
+      required:
+        - capacity
+        - controllable
+        - power
+        - soc
+    BatteryMode:
+      description: Battery operation mode.
+      type: string
+      enum:
+        - unknown
+        - normal
+        - hold
+        - charge
+        - holdcharge
+    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"
+    ForecastSlot:
+      description: A forecast value for a time slot.
       type: object
-      description: A charging interval
       properties:
         start:
-          description: Start
-          $ref: "#/components/schemas/Timestamp"
+          description: Start of the time slot.
+          type: string
+          format: date-time
         end:
-          description: End
-          $ref: "#/components/schemas/Timestamp"
+          description: End of the time slot.
+          type: string
+          format: date-time
         value:
-          description: Cost
+          description: Forecast value of the time slot. Unit depends on the forecast type.
           type: number
-          minimum: 0
-    Rates:
-      type: array
-      items:
-        $ref: "#/components/schemas/Rate"
+      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
+            - "null"
+        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.
+          anyOf:
+            - $ref: "#/components/schemas/ChargerStatusReason"
+            - type: "null"
+        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
+        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
+            - "null"
+          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
+        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.
+          anyOf:
+            - type: array
+              items:
+                $ref: "#/components/schemas/Rate"
+            - type: "null"
+        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
+            - "null"
+          format: date-time
+        planProjectedStart:
+          description: Projected start of the charging plan. Start of the earliest planned slot.
+          type:
+            - string
+            - "null"
+          format: date-time
+        planTime:
+          description: Target time of the charging plan.
+          type:
+            - string
+            - "null"
+          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
+        sessionCo2PerKWh:
+          description: Average CO₂ emissions of the current charging session in g/kWh.
+          type:
+            - number
+            - "null"
+        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
+            - "null"
+        sessionPricePerKWh:
+          description: Average energy price of the current charging session per kWh in the configured currency.
+          type:
+            - number
+            - "null"
+        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
+            - "null"
+        smartCostNextStart:
+          description: Start of the next fast charging period with cheap or clean grid energy.
+          type:
+            - string
+            - "null"
+          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
+            - "null"
+        smartFeedInPriorityNextStart:
+          description: Start of the next charging pause for prioritized feed-in.
+          type:
+            - string
+            - "null"
+          format: date-time
+        title:
+          description: Loadpoint title for UI display.
+          type: string
+        vehicleClimaterActive:
+          description: Climater of the connected vehicle is active.
+          type:
+            - boolean
+            - "null"
+        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
+        - effectivePlanId
+        - effectivePlanSoc
+        - effectivePlanTime
+        - effectivePlanStrategy
+        - effectivePriority
+        - enableDelay
+        - enableThreshold
+        - enabled
+        - limitEnergy
+        - limitSoc
+        - maxCurrent
+        - minCurrent
+        - 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
+    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"
+      required:
+        - start
+        - stop
+        - connect
+        - disconnect
+        - soc
+        - guest
+        - asleep
+        - planoverrun
+      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 configuration
+      description: Charging plan strategy.
       type: object
       properties:
         continuous:
-          description: "Force continuous planning"
+          description: Force continuous charging without gaps.
           type: boolean
         precondition:
-          description: "Precondition duration in seconds"
-          type: integer
-          minimum: 0
-    RepeatingPlan:
-      externalDocs:
-        url: https://docs.evcc.io/en/docs/features/plans#repeating-plans
+          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:
-        active:
-          description: "Set plan active."
+        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
-        soc:
-          $ref: "#/components/schemas/Soc"
+      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:
-          $ref: "#/components/schemas/HourMinuteTime"
+          description: Target time in HH:MM format.
+          type: string
         tz:
-          $ref: "#/components/schemas/IANATimeZone"
-        weekdays:
-          $ref: "#/components/schemas/Weekdays"
-    Soc:
-      description: SOC in %
-      type: number
-      example: 60
-      minimum: 0
-      maximum: 100
-    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."
+          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:
-      externalDocs:
-        url: https://docs.evcc.io/en/docs/features/plans#energy-amount-plan
+      description: Charging plan with an energy goal.
       type: object
       properties:
         energy:
-          $ref: "#/components/schemas/Energy"
+          description: Energy goal in kWh.
+          type: number
         time:
-          $ref: "#/components/schemas/Timestamp"
+          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:
-      externalDocs:
-        url: https://docs.evcc.io/en/docs/features/plans#create-charging-plan
+      description: Charging plan with a SoC goal.
       type: object
       properties:
         soc:
-          $ref: "#/components/schemas/Soc"
+          description: SoC goal in %.
+          type: number
         time:
-          $ref: "#/components/schemas/Timestamp"
+          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
+        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.
+          anyOf:
+            - type: array
+              items:
+                $ref: "#/components/schemas/RepeatingPlan"
+            - type: "null"
+        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
+    # GENERATED_STATE_SCHEMAS_END
     Timestamp:
       description: Timestamp in RFC3339 format
       type: string
@@ -1759,7 +3422,7 @@ components:
       in: path
       required: true
       schema:
-        $ref: "#/components/schemas/Mode"
+        $ref: "#/components/schemas/ChargeMode"
     soc:
       name: soc
       description: SOC in %
diff --git a/tests/state-api.spec.ts b/tests/state-api.spec.ts
new file mode 100644
index 00000000000..2b8f699ac72
--- /dev/null
+++ b/tests/state-api.spec.ts
@@ -0,0 +1,25 @@
+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];
+    })
+    .toEqual([]);
+});
diff --git a/tsconfig.json b/tsconfig.json
index dd2d54772c8..7def183653f 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,

From f266a9d38c07af408ab3c4a378cf0d073f7eeb05 Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Mon, 6 Jul 2026 14:34:44 +0200
Subject: [PATCH 2/8] API: dedicated state tag and operation id

---
 server/mcp/openapi.json |  7 +++++--
 server/mcp/openapi.md   | 40 ++++++++++++++++++++--------------------
 server/openapi.yaml     |  5 +++--
 3 files changed, 28 insertions(+), 24 deletions(-)

diff --git a/server/mcp/openapi.json b/server/mcp/openapi.json
index 3ba8d8b2e12..ce56fc8fc44 100644
--- a/server/mcp/openapi.json
+++ b/server/mcp/openapi.json
@@ -4745,7 +4745,7 @@
     "/state": {
       "get": {
         "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.",
-        "operationId": "getState",
+        "operationId": "state",
         "parameters": [
           {
             "description": "Filter the state with JQ",
@@ -4780,7 +4780,7 @@
         },
         "summary": "System state",
         "tags": [
-          "general"
+          "state"
         ]
       }
     },
@@ -5231,6 +5231,9 @@
     }
   },
   "tags": [
+    {
+      "name": "state"
+    },
     {
       "name": "auth"
     },
diff --git a/server/mcp/openapi.md b/server/mcp/openapi.md
index fe839ce18b2..ed447cfe060 100644
--- a/server/mcp/openapi.md
+++ b/server/mcp/openapi.md
@@ -344,26 +344,6 @@ call getEnergyHistory {
 }
 ```
 
-## getState
-
-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.
-
-**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.
@@ -1104,6 +1084,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.
+
+**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.yaml b/server/openapi.yaml
index ef3355297a6..519c7df1fa1 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
@@ -925,11 +926,11 @@ 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 and also published via websocket and MQTT. It can be filtered by JQ to only return a subset of the data."
       tags:
-        - general
+        - state
       parameters:
         - name: jq
           in: query

From 7501914f4d9d1e24be3c9eec437e321a0abbb69f Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Mon, 6 Jul 2026 14:38:56 +0200
Subject: [PATCH 3/8] chore: emit 3.0-style nullable for kin-openapi
 compatibility

---
 scripts/state-schema/schemas.ts  |  34 +++++++
 scripts/state-schema/validate.ts |  19 ++++
 server/mcp/openapi.json          | 162 +++++++++++--------------------
 server/openapi.yaml              | 111 +++++++++------------
 4 files changed, 153 insertions(+), 173 deletions(-)

diff --git a/scripts/state-schema/schemas.ts b/scripts/state-schema/schemas.ts
index d4f7b640b98..c2aac248e11 100644
--- a/scripts/state-schema/schemas.ts
+++ b/scripts/state-schema/schemas.ts
@@ -93,6 +93,34 @@ function reachableDefs(
   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 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) => {
@@ -128,6 +156,9 @@ export function buildSchemas(): StateSchemas {
   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)
@@ -151,13 +182,16 @@ 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
diff --git a/scripts/state-schema/validate.ts b/scripts/state-schema/validate.ts
index a5be7e7ab7c..f2c32377cf8 100644
--- a/scripts/state-schema/validate.ts
+++ b/scripts/state-schema/validate.ts
@@ -47,10 +47,29 @@ function coverage(
   }
 }
 
+// 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.yaml
 export function validateState(payload: any): { errors: string[]; undocumented: string[] } {
   const doc = parse(readFileSync(OPENAPI_PATH, "utf8"));
   const schemas: Record<string, AnySchema> = doc.components.schemas;
+  expandNullable(schemas);
 
   const ajv = new Ajv2020({ strict: false, allErrors: true });
   const validateFn = ajv.compile({
diff --git a/server/mcp/openapi.json b/server/mcp/openapi.json
index ce56fc8fc44..5972b27b750 100644
--- a/server/mcp/openapi.json
+++ b/server/mcp/openapi.json
@@ -1177,10 +1177,8 @@
           },
           "chargerIcon": {
             "description": "Charger icon name for UI display.",
-            "type": [
-              "string",
-              "null"
-            ]
+            "nullable": true,
+            "type": "string"
           },
           "chargerPhases1p3p": {
             "description": "Charger supports automatic switching between 1-phase and 3-phase charging.",
@@ -1191,15 +1189,13 @@
             "type": "boolean"
           },
           "chargerStatusReason": {
-            "anyOf": [
+            "allOf": [
               {
                 "$ref": "#/components/schemas/ChargerStatusReason"
-              },
-              {
-                "type": "null"
               }
             ],
-            "description": "Reason why the charger is waiting, like a pending authorization or a required disconnect."
+            "description": "Reason why the charger is waiting, like a pending authorization or a required disconnect.",
+            "nullable": true
           },
           "charging": {
             "description": "A vehicle is connected and charging.",
@@ -1247,10 +1243,8 @@
           "effectivePlanTime": {
             "description": "Target time of the currently applied charging plan.",
             "format": "date-time",
-            "type": [
-              "string",
-              "null"
-            ]
+            "nullable": true,
+            "type": "string"
           },
           "effectivePriority": {
             "description": "Currently applied priority.",
@@ -1315,18 +1309,12 @@
             "type": "number"
           },
           "plan": {
-            "anyOf": [
-              {
-                "items": {
-                  "$ref": "#/components/schemas/Rate"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Time slots of the current charging plan."
+            "description": "Time slots of the current charging plan.",
+            "items": {
+              "$ref": "#/components/schemas/Rate"
+            },
+            "nullable": true,
+            "type": "array"
           },
           "planActive": {
             "description": "The current time slot is an active charging slot of the plan.",
@@ -1343,18 +1331,14 @@
           "planProjectedEnd": {
             "description": "Projected end of the charging plan. End of the last planned slot.",
             "format": "date-time",
-            "type": [
-              "string",
-              "null"
-            ]
+            "nullable": true,
+            "type": "string"
           },
           "planProjectedStart": {
             "description": "Projected start of the charging plan. Start of the earliest planned slot.",
             "format": "date-time",
-            "type": [
-              "string",
-              "null"
-            ]
+            "nullable": true,
+            "type": "string"
           },
           "planStrategy": {
             "$ref": "#/components/schemas/PlanStrategy"
@@ -1362,10 +1346,8 @@
           "planTime": {
             "description": "Target time of the charging plan.",
             "format": "date-time",
-            "type": [
-              "string",
-              "null"
-            ]
+            "nullable": true,
+            "type": "string"
           },
           "priority": {
             "description": "Priority for surplus distribution. Higher number means higher priority.",
@@ -1380,10 +1362,8 @@
           },
           "sessionCo2PerKWh": {
             "description": "Average CO₂ emissions of the current charging session in g/kWh.",
-            "type": [
-              "number",
-              "null"
-            ]
+            "nullable": true,
+            "type": "number"
           },
           "sessionEnergy": {
             "description": "Energy charged in the current charging session in kWh.",
@@ -1391,17 +1371,13 @@
           },
           "sessionPrice": {
             "description": "Total cost of the current charging session in the configured currency.",
-            "type": [
-              "number",
-              "null"
-            ]
+            "nullable": true,
+            "type": "number"
           },
           "sessionPricePerKWh": {
             "description": "Average energy price of the current charging session per kWh in the configured currency.",
-            "type": [
-              "number",
-              "null"
-            ]
+            "nullable": true,
+            "type": "number"
           },
           "sessionSolarPercentage": {
             "description": "Share of solar energy in the current charging session in %.",
@@ -1413,18 +1389,14 @@
           },
           "smartCostLimit": {
             "description": "Price or emission limit for fast charging with grid energy.",
-            "type": [
-              "number",
-              "null"
-            ]
+            "nullable": true,
+            "type": "number"
           },
           "smartCostNextStart": {
             "description": "Start of the next fast charging period with cheap or clean grid energy.",
             "format": "date-time",
-            "type": [
-              "string",
-              "null"
-            ]
+            "nullable": true,
+            "type": "string"
           },
           "smartFeedInPriorityActive": {
             "description": "Charging pause for prioritized feed-in is currently active.",
@@ -1432,18 +1404,14 @@
           },
           "smartFeedInPriorityLimit": {
             "description": "Feed-in rate limit above which charging is paused.",
-            "type": [
-              "number",
-              "null"
-            ]
+            "nullable": true,
+            "type": "number"
           },
           "smartFeedInPriorityNextStart": {
             "description": "Start of the next charging pause for prioritized feed-in.",
             "format": "date-time",
-            "type": [
-              "string",
-              "null"
-            ]
+            "nullable": true,
+            "type": "string"
           },
           "title": {
             "description": "Loadpoint title for UI display.",
@@ -1454,10 +1422,8 @@
           },
           "vehicleClimaterActive": {
             "description": "Climater of the connected vehicle is active.",
-            "type": [
-              "boolean",
-              "null"
-            ]
+            "nullable": true,
+            "type": "boolean"
           },
           "vehicleDetectionActive": {
             "description": "Automatic vehicle detection is running.",
@@ -2436,10 +2402,8 @@
           },
           "batteryGridChargeLimit": {
             "description": "Price or emission limit for charging the home battery from grid.",
-            "type": [
-              "number",
-              "null"
-            ]
+            "nullable": true,
+            "type": "number"
           },
           "batteryMode": {
             "$ref": "#/components/schemas/BatteryMode"
@@ -2561,29 +2525,21 @@
             "$ref": "#/components/schemas/GenericConfigStatus"
           },
           "messagingEvents": {
-            "anyOf": [
+            "allOf": [
               {
                 "$ref": "#/components/schemas/MessagingEvents"
-              },
-              {
-                "type": "null"
               }
             ],
-            "description": "Configured notification messages per event type."
+            "description": "Configured notification messages per event type.",
+            "nullable": true
           },
           "modbusproxy": {
-            "anyOf": [
-              {
-                "items": {
-                  "$ref": "#/components/schemas/ModbusProxy"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Modbus proxy configuration."
+            "description": "Modbus proxy configuration.",
+            "items": {
+              "$ref": "#/components/schemas/ModbusProxy"
+            },
+            "nullable": true,
+            "type": "array"
           },
           "mqtt": {
             "$ref": "#/components/schemas/MqttConfig"
@@ -2672,9 +2628,7 @@
           },
           "system": {
             "description": "Operating system and architecture.",
-            "examples": [
-              "linux/amd64"
-            ],
+            "example": "linux/amd64",
             "type": "string"
           },
           "tariffCo2": {
@@ -2718,9 +2672,7 @@
           },
           "timezone": {
             "description": "Server time zone abbreviation and UTC offset.",
-            "examples": [
-              "CEST +02:00"
-            ],
+            "example": "CEST +02:00",
             "type": "string"
           },
           "vehicles": {
@@ -2904,18 +2856,12 @@
             "$ref": "#/components/schemas/PlanStrategy"
           },
           "repeatingPlans": {
-            "anyOf": [
-              {
-                "items": {
-                  "$ref": "#/components/schemas/RepeatingPlan"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Repeating charging plans."
+            "description": "Repeating charging plans.",
+            "items": {
+              "$ref": "#/components/schemas/RepeatingPlan"
+            },
+            "nullable": true,
+            "type": "array"
           },
           "title": {
             "description": "Vehicle title for UI display.",
diff --git a/server/openapi.yaml b/server/openapi.yaml
index 519c7df1fa1..3dbf4e71be3 100644
--- a/server/openapi.yaml
+++ b/server/openapi.yaml
@@ -1627,13 +1627,11 @@ components:
         system:
           description: Operating system and architecture.
           type: string
-          examples:
-            - linux/amd64
+          example: linux/amd64
         timezone:
           description: Server time zone abbreviation and UTC offset.
           type: string
-          examples:
-            - CEST +02:00
+          example: CEST +02:00
         battery:
           $ref: "#/components/schemas/Battery"
           description: Aggregated home battery state.
@@ -1740,19 +1738,18 @@ components:
           description: Remote access configuration and connection status.
         modbusproxy:
           description: Modbus proxy configuration.
-          anyOf:
-            - type: array
-              items:
-                $ref: "#/components/schemas/ModbusProxy"
-            - type: "null"
+          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.
-          anyOf:
+          nullable: true
+          allOf:
             - $ref: "#/components/schemas/MessagingEvents"
-            - type: "null"
         interval:
           description: Update interval of the control loop in seconds.
           type: number
@@ -1775,9 +1772,8 @@ components:
           type: boolean
         batteryGridChargeLimit:
           description: Price or emission limit for charging the home battery from grid.
-          type:
-            - number
-            - "null"
+          type: number
+          nullable: true
         batteryGridChargeActive:
           description: Home battery is currently charged from grid.
           type: boolean
@@ -2353,9 +2349,8 @@ components:
           type: boolean
         chargerIcon:
           description: Charger icon name for UI display.
-          type:
-            - string
-            - "null"
+          type: string
+          nullable: true
         chargerPhases1p3p:
           description: Charger supports automatic switching between 1-phase and 3-phase charging.
           type: boolean
@@ -2364,9 +2359,9 @@ components:
           type: boolean
         chargerStatusReason:
           description: Reason why the charger is waiting, like a pending authorization or a required disconnect.
-          anyOf:
+          nullable: true
+          allOf:
             - $ref: "#/components/schemas/ChargerStatusReason"
-            - type: "null"
         charging:
           description: A vehicle is connected and charging.
           type: boolean
@@ -2399,9 +2394,8 @@ components:
           type: number
         effectivePlanTime:
           description: Target time of the currently applied charging plan.
-          type:
-            - string
-            - "null"
+          type: string
+          nullable: true
           format: date-time
         effectivePlanStrategy:
           $ref: "#/components/schemas/PlanStrategy"
@@ -2453,11 +2447,10 @@ components:
           type: number
         plan:
           description: Time slots of the current charging plan.
-          anyOf:
-            - type: array
-              items:
-                $ref: "#/components/schemas/Rate"
-            - type: "null"
+          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
@@ -2472,21 +2465,18 @@ components:
           description: Charging plan strategy.
         planProjectedEnd:
           description: Projected end of the charging plan. End of the last planned slot.
-          type:
-            - string
-            - "null"
+          type: string
+          nullable: true
           format: date-time
         planProjectedStart:
           description: Projected start of the charging plan. Start of the earliest planned slot.
-          type:
-            - string
-            - "null"
+          type: string
+          nullable: true
           format: date-time
         planTime:
           description: Target time of the charging plan.
-          type:
-            - string
-            - "null"
+          type: string
+          nullable: true
           format: date-time
         priority:
           description: Priority for surplus distribution. Higher number means higher priority.
@@ -2499,22 +2489,19 @@ components:
           type: number
         sessionCo2PerKWh:
           description: Average CO₂ emissions of the current charging session in g/kWh.
-          type:
-            - number
-            - "null"
+          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
-            - "null"
+          type: number
+          nullable: true
         sessionPricePerKWh:
           description: Average energy price of the current charging session per kWh in the configured currency.
-          type:
-            - number
-            - "null"
+          type: number
+          nullable: true
         sessionSolarPercentage:
           description: Share of solar energy in the current charging session in %.
           type: number
@@ -2523,37 +2510,32 @@ components:
           type: boolean
         smartCostLimit:
           description: Price or emission limit for fast charging with grid energy.
-          type:
-            - number
-            - "null"
+          type: number
+          nullable: true
         smartCostNextStart:
           description: Start of the next fast charging period with cheap or clean grid energy.
-          type:
-            - string
-            - "null"
+          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
-            - "null"
+          type: number
+          nullable: true
         smartFeedInPriorityNextStart:
           description: Start of the next charging pause for prioritized feed-in.
-          type:
-            - string
-            - "null"
+          type: string
+          nullable: true
           format: date-time
         title:
           description: Loadpoint title for UI display.
           type: string
         vehicleClimaterActive:
           description: Climater of the connected vehicle is active.
-          type:
-            - boolean
-            - "null"
+          type: boolean
+          nullable: true
         vehicleDetectionActive:
           description: Automatic vehicle detection is running.
           type: boolean
@@ -3300,11 +3282,10 @@ components:
           description: Charging plan with a fixed target time and SoC or energy goal.
         repeatingPlans:
           description: Repeating charging plans.
-          anyOf:
-            - type: array
-              items:
-                $ref: "#/components/schemas/RepeatingPlan"
-            - type: "null"
+          type: array
+          nullable: true
+          items:
+            $ref: "#/components/schemas/RepeatingPlan"
         planStrategy:
           $ref: "#/components/schemas/PlanStrategy"
           description: Charging plan strategy.

From 76b09236ab13916ff3e22179cb701f53ee0a871d Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Mon, 6 Jul 2026 14:47:19 +0200
Subject: [PATCH 4/8] UI: centralize forecast types

---
 assets/js/components/Forecast/Chart.vue       |  3 +-
 assets/js/components/Forecast/Co2Chart.vue    |  2 +-
 assets/js/components/Forecast/Co2Details.vue  |  2 +-
 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/echarts.ts      |  2 +-
 assets/js/components/Forecast/types.ts        | 52 -------------------
 .../js/components/Tariff/SmartCostLimit.vue   |  3 +-
 assets/js/types/evcc.ts                       | 51 +++++++++++++++++-
 assets/js/utils/forecast.ts                   |  2 +-
 12 files changed, 59 insertions(+), 68 deletions(-)
 delete mode 100644 assets/js/components/Forecast/types.ts

diff --git a/assets/js/components/Forecast/Chart.vue b/assets/js/components/Forecast/Chart.vue
index 1ae1a806e90..3238a85fbf0 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/Co2Chart.vue b/assets/js/components/Forecast/Co2Chart.vue
index f3e4c616461..63b8a6336dc 100644
--- a/assets/js/components/Forecast/Co2Chart.vue
+++ b/assets/js/components/Forecast/Co2Chart.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 default defineComponent({
 	name: "Co2Chart",
diff --git a/assets/js/components/Forecast/Co2Details.vue b/assets/js/components/Forecast/Co2Details.vue
index 3358f0b5d7f..202c14cfc39 100644
--- a/assets/js/components/Forecast/Co2Details.vue
+++ b/assets/js/components/Forecast/Co2Details.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";
 
 const MAX_HOURS = 96;
 const SLOTS_PER_HOUR = 4;
diff --git a/assets/js/components/Forecast/GridDetails.vue b/assets/js/components/Forecast/GridDetails.vue
index 70d5cecb01e..012febe7f5a 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 3b416fa608e..0d0f7c9d188 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 750ede61268..a29c061365a 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 32497c1908a..18414ba69fc 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/echarts.ts b/assets/js/components/Forecast/echarts.ts
index 902453f4633..bb0fc16cd42 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 afead1786ba..00000000000
--- a/assets/js/components/Forecast/types.ts
+++ /dev/null
@@ -1,52 +0,0 @@
-export function isForecastSlot(obj?: TimeseriesEntry | ForecastSlot): obj is ForecastSlot {
-  return (obj as ForecastSlot).start !== undefined;
-}
-
-/** 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[];
-}
diff --git a/assets/js/components/Tariff/SmartCostLimit.vue b/assets/js/components/Tariff/SmartCostLimit.vue
index 89383a28b32..c8b90806070 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/types/evcc.ts b/assets/js/types/evcc.ts
index fb09fb3b68a..4d4dbee91a2 100644
--- a/assets/js/types/evcc.ts
+++ b/assets/js/types/evcc.ts
@@ -1,5 +1,3 @@
-import type { ForecastSlot, SolarDetails } from "../components/Forecast/types";
-
 // react-native-webview
 interface WebView {
   postMessage: (message: string) => void;
@@ -1214,6 +1212,55 @@ 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. */
diff --git a/assets/js/utils/forecast.ts b/assets/js/utils/forecast.ts
index e1871949373..a5c14d1143b 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 {

From 5f4b3dd7dd58450bea74702252b060f56264bf9c Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Mon, 13 Jul 2026 14:57:26 +0200
Subject: [PATCH 5/8] API: split generated state schemas into
 openapi.state.yaml, bundle for MCP

---
 .github/workflows/documentation.yml    |    2 +-
 .github/workflows/openapi-validate.yml |    3 +-
 .gitignore                             |    1 +
 assets/js/types/evcc.ts                |    3 +-
 cmd/openapi/openapi.go                 |   28 -
 go.mod                                 |    1 -
 package-lock.json                      |  167 +
 package.json                           |    1 +
 scripts/state-schema/index.ts          |    9 +-
 scripts/state-schema/openapi.ts        |   68 +-
 scripts/state-schema/validate.ts       |    6 +-
 server/mcp/openapi.json                | 9290 ++++++++++++------------
 server/mcp/openapi.md                  |    2 +-
 server/openapi.go                      |    3 +-
 server/openapi.state.yaml              | 1730 +++++
 server/openapi.yaml                    | 1755 +----
 server/openapi_test.go                 |    1 +
 17 files changed, 6621 insertions(+), 6449 deletions(-)
 delete mode 100644 cmd/openapi/openapi.go
 create mode 100644 server/openapi.state.yaml

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 37d36e1a49d..f5dc4598cd0 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 6e0999ad69e..3a6176d76bb 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 48573ca2ab5..dd0405372fb 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/types/evcc.ts b/assets/js/types/evcc.ts
index 4d4dbee91a2..a0abc130907 100644
--- a/assets/js/types/evcc.ts
+++ b/assets/js/types/evcc.ts
@@ -137,7 +137,8 @@ export type Statistics = Record<StatisticsPeriod, StatisticsData>;
 
 /**
  * Complete system state as returned by /api/state and pushed via websocket and MQTT.
- * The overall structure is stable, details may change between releases.
+ * This structure mirrors the internal UI state and carries no compatibility promise.
+ * Fields may change or disappear between releases.
  */
 export interface State {
   /** @internal */
diff --git a/cmd/openapi/openapi.go b/cmd/openapi/openapi.go
deleted file mode 100644
index 366d62ff836..00000000000
--- 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/go.mod b/go.mod
index de0e554149f..8e1e2c7cc50 100644
--- a/go.mod
+++ b/go.mod
@@ -251,7 +251,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 c382af5f3ad..c6b3ed84fe9 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",
@@ -3622,6 +3623,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",
@@ -5407,6 +5490,24 @@
         "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",
@@ -6325,6 +6426,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",
@@ -8269,6 +8377,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",
@@ -9179,6 +9297,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",
@@ -9253,6 +9381,21 @@
       "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": "1.0.0",
       "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
@@ -10600,6 +10743,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",
@@ -12611,6 +12764,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",
@@ -14468,6 +14628,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 48ecc4943ba..1190c236e7f 100644
--- a/package.json
+++ b/package.json
@@ -59,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",
diff --git a/scripts/state-schema/index.ts b/scripts/state-schema/index.ts
index 66e84e4de79..e543d15ebc8 100644
--- a/scripts/state-schema/index.ts
+++ b/scripts/state-schema/index.ts
@@ -1,16 +1,15 @@
 import { buildSchemas } from "./schemas";
-import { spliceOpenapi } from "./openapi";
+import { writeStateSchemas, bundleMcpJson } from "./openapi";
 
 const command = process.argv[2] ?? "generate";
 
 switch (command) {
   case "generate": {
     const schemas = buildSchemas();
-    const changed = await spliceOpenapi(schemas);
+    await writeStateSchemas(schemas);
+    await bundleMcpJson();
     console.log(
-      changed
-        ? `server/openapi.yaml updated (${Object.keys(schemas.defs).length} schemas)`
-        : "server/openapi.yaml unchanged"
+      `${Object.keys(schemas.defs).length} state schemas → openapi.state.yaml + mcp/openapi.json`
     );
     break;
   }
diff --git a/scripts/state-schema/openapi.ts b/scripts/state-schema/openapi.ts
index 0eea7816d74..0b70df4579f 100644
--- a/scripts/state-schema/openapi.ts
+++ b/scripts/state-schema/openapi.ts
@@ -1,58 +1,40 @@
 import { readFileSync, writeFileSync } from "node:fs";
-import { stringify } from "yaml";
+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 BEGIN = "# GENERATED_STATE_SCHEMAS_BEGIN";
-const END = "# GENERATED_STATE_SCHEMAS_END";
-const INDENT = "    "; // components.schemas entry level
+const STATE_PATH = "server/openapi.state.yaml";
+const MCP_JSON_PATH = "server/mcp/openapi.json";
 
-function markerBounds(text: string): { begin: number; end: number } {
-  if (text.split(BEGIN).length !== 2 || text.split(END).length !== 2) {
-    throw new Error(`expected exactly one ${BEGIN} and one ${END} marker in ${OPENAPI_PATH}`);
-  }
-  const begin = text.indexOf("\n", text.indexOf(BEGIN)) + 1;
-  const end = text.lastIndexOf("\n", text.indexOf(END)) + 1;
-  if (begin > end) throw new Error("markers out of order");
-  return { begin, end };
-}
-
-// schema names defined outside the generated block
-function handWrittenNames(text: string, begin: number, end: number): Set<string> {
-  const outside = text.slice(0, begin) + text.slice(end);
-  const schemasSection = outside.match(/^ {2}schemas:\n([\s\S]*?)(?=^ {2}[a-zA-Z]|(?![\s\S]))/m);
-  if (!schemasSection) throw new Error("components.schemas section not found");
-  const names = new Set<string>();
-  for (const line of schemasSection[1].matchAll(/^ {4}([a-zA-Z0-9._-]+):/gm)) {
-    names.add(line[1]);
-  }
-  return names;
-}
-
-export async function spliceOpenapi(schemas: StateSchemas): Promise<boolean> {
-  const text = readFileSync(OPENAPI_PATH, "utf8");
-  const { begin, end } = markerBounds(text);
+const HEADER = `# GENERATED FILE - DO NOT EDIT (source: assets/js/types/evcc.ts, update: npm run openapi)
+`;
 
-  const existing = handWrittenNames(text, begin, end);
+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 (existing.has(name)) {
+    if (handWritten.has(name)) {
       throw new Error(`generated schema "${name}" collides with hand-written component`);
     }
   }
 
-  const block = stringify(schemas.defs, { lineWidth: 0, aliasDuplicateObjects: false })
-    .trimEnd()
-    .split("\n")
-    .map((line) => (line.length > 0 ? INDENT + line : line))
-    .join("\n");
+  const doc =
+    HEADER +
+    stringify(
+      { components: { schemas: schemas.defs } },
+      { lineWidth: 0, aliasDuplicateObjects: false }
+    );
 
-  const spliced = text.slice(0, begin) + block + "\n" + text.slice(end);
-
-  const config = await prettier.resolveConfig(OPENAPI_PATH);
-  const formatted = await prettier.format(spliced, { ...config, filepath: OPENAPI_PATH });
+  const config = await prettier.resolveConfig(STATE_PATH);
+  writeFileSync(STATE_PATH, await prettier.format(doc, { ...config, filepath: STATE_PATH }));
+}
 
-  if (formatted === text) return false;
-  writeFileSync(OPENAPI_PATH, formatted);
-  return true;
+// 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/validate.ts b/scripts/state-schema/validate.ts
index f2c32377cf8..e61beca68b1 100644
--- a/scripts/state-schema/validate.ts
+++ b/scripts/state-schema/validate.ts
@@ -2,7 +2,7 @@ import { readFileSync } from "node:fs";
 import { parse } from "yaml";
 import { Ajv2020 } from "ajv/dist/2020.js";
 
-const OPENAPI_PATH = "server/openapi.yaml";
+const STATE_SCHEMAS_PATH = "server/openapi.state.yaml";
 
 // intentionally undocumented experimental structures
 const IGNORE = new Set(["$.evopt", "$.evopt-batteries"]);
@@ -65,9 +65,9 @@ function expandNullable(node: any): void {
   }
 }
 
-// validate a /api/state payload against the State schema in server/openapi.yaml
+// 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(OPENAPI_PATH, "utf8"));
+  const doc = parse(readFileSync(STATE_SCHEMAS_PATH, "utf8"));
   const schemas: Record<string, AnySchema> = doc.components.schemas;
   expandNullable(schemas);
 
diff --git a/server/mcp/openapi.json b/server/mcp/openapi.json
index 5972b27b750..a9c6e3564f4 100644
--- a/server/mcp/openapi.json
+++ b/server/mcp/openapi.json
@@ -1,2077 +1,2508 @@
 {
-  "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"
+  "openapi": "3.1.0",
+  "info": {
+    "title": "evcc",
+    "description": "Solar charging. Super simple.",
+    "version": "0.2.0",
+    "contact": {
+      "url": "https://github.com/evcc-io/evcc"
+    }
+  },
+  "tags": [
+    {
+      "name": "state"
+    },
+    {
+      "name": "auth"
+    },
+    {
+      "name": "battery"
+    },
+    {
+      "name": "db"
+    },
+    {
+      "name": "experimental"
+    },
+    {
+      "name": "general"
+    },
+    {
+      "name": "loadpoints"
+    },
+    {
+      "name": "sessions"
+    },
+    {
+      "name": "system"
+    },
+    {
+      "name": "tariffs"
+    },
+    {
+      "name": "vehicles"
+    }
+  ],
+  "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"
+          }
         }
-      },
-      "current": {
-        "description": "Electric current in A",
-        "in": "path",
-        "name": "current",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Current"
+      }
+    },
+    "/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"
+                  ]
+                }
+              }
+            }
+          }
         }
-      },
-      "delay": {
-        "description": "Duration in seconds.",
-        "in": "path",
-        "name": "delay",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Delay"
+      }
+    },
+    "/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"
+          }
         }
-      },
-      "enable": {
-        "description": "Charging mode.",
-        "in": "path",
-        "name": "enable",
-        "required": true,
-        "schema": {
-          "enum": [
-            "true",
-            "false",
-            "1",
-            "0"
-          ],
-          "type": "string"
+      }
+    },
+    "/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"
+                  ]
+                }
+              }
+            }
+          }
         }
-      },
-      "energy": {
-        "description": "Energy in kWh",
-        "in": "path",
-        "name": "energy",
-        "required": true,
-        "schema": {
-          "$ref": "#/components/schemas/Energy"
+      }
+    },
+    "/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"
+          }
         }
       },
-      "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/ChargeMode"
-        }
-      },
-      "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"
-        }
-      },
-      "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": {
-              "properties": {
-                "result": {
-                  "description": "Battery mode. 0: unknown, 1: normal, 2: hold, 3: charge, 4: holdcharge",
-                  "maximum": 4,
-                  "minimum": 0,
-                  "type": "integer"
+      "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"
+                  }
                 }
-              },
-              "type": "object"
+              }
             }
           }
         },
-        "description": "Battery mode"
-      },
-      "BlankResponse": {
-        "description": "Success - Blank response"
-      },
-      "BooleanResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "properties": {
-                "result": {
-                  "type": "boolean"
+        "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"
+                    }
+                  }
                 }
-              },
-              "type": "object"
+              }
             }
+          },
+          "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/docs/features/battery"
         },
-        "description": "Success - Boolean result"
-      },
-      "EmptyResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "object"
-            }
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/enable"
           }
-        },
-        "description": "Success - Empty result"
-      },
-      "IntegerResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "properties": {
-                "result": {
-                  "type": "integer"
-                }
-              },
-              "type": "object"
-            }
+        ],
+        "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/docs/features/battery"
         },
-        "description": "Success - Integer result"
-      },
-      "NanoSecondsResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "properties": {
-                "result": {
-                  "type": "integer"
-                }
-              },
-              "type": "object"
-            }
+        "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/docs/features/battery"
         },
-        "description": "Success - Number result - Unit is **nanoseconds**"
-      },
-      "NullResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "properties": {
-                "result": {
-                  "description": "Value is always null",
-                  "nullable": true,
-                  "type": "object"
-                }
-              },
-              "type": "object"
-            }
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/costLimit"
           }
-        },
-        "description": "Success - Null result"
-      },
-      "NumberResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "properties": {
-                "result": {
-                  "type": "number"
-                }
-              },
-              "type": "object"
-            }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
           }
-        },
-        "description": "Success - Number result"
-      },
-      "PlanRatesResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "properties": {
-                "result": {
-                  "$ref": "#/components/schemas/PlanRates"
-                }
-              },
-              "type": "object"
-            }
+        }
+      }
+    },
+    "/batterymode": {
+      "delete": {
+        "operationId": "disableExternalBatteryControl",
+        "summary": "Disable external battery control",
+        "description": "Default evcc control behavior is restored",
+        "tags": [
+          "battery"
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/BatteryModeResult"
           }
-        },
-        "description": "Success - PlanRates result"
-      },
-      "SocResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "properties": {
-                "result": {
-                  "properties": {
-                    "soc": {
-                      "$ref": "#/components/schemas/Soc"
-                    }
-                  },
-                  "type": "object"
-                }
-              },
-              "type": "object"
-            }
+        }
+      }
+    },
+    "/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"
           }
-        },
-        "description": "Success - Soc result"
-      },
-      "SuccessResult": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "properties": {
-                "result": {
-                  "example": "OK",
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            }
+        ],
+        "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/docs/features/battery"
         },
-        "description": "Success"
-      },
-      "Unauthorized": {
-        "content": {
-          "text/plain": {
-            "schema": {
-              "enum": [
-                "Unauthorized"
-              ],
-              "type": "string"
-            }
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/soc"
           }
-        },
-        "description": "Unauthorized - Login and try again"
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
       }
     },
-    "schemas": {
-      "AuthProviders": {
-        "additionalProperties": {
-          "properties": {
-            "authenticated": {
-              "type": "boolean"
-            },
-            "id": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "authenticated"
-          ],
-          "type": "object"
+    "/bufferstartsoc/{soc}": {
+      "post": {
+        "operationId": "setBufferStartSoc",
+        "summary": "Set battery buffer start SoC",
+        "description": "Set battery buffer start SoC.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/features/battery"
         },
-        "description": "Status of configured vehicle authentication providers, keyed by provider name.",
-        "type": "object"
-      },
-      "Battery": {
-        "description": "Home battery state. Aggregated across all battery meters.",
-        "properties": {
-          "capacity": {
-            "description": "Total battery capacity in kWh.",
-            "type": "number"
-          },
-          "devices": {
-            "description": "Measurement data per battery meter.",
-            "items": {
-              "$ref": "#/components/schemas/BatteryMeter"
-            },
-            "type": "array"
-          },
-          "energy": {
-            "description": "Total battery energy in kWh.",
-            "type": "number"
-          },
-          "forecast": {
-            "$ref": "#/components/schemas/BatteryForecast"
-          },
-          "power": {
-            "description": "Current battery power in W. Positive means discharging, negative means charging.",
-            "type": "number"
-          },
-          "soc": {
-            "description": "Charge level in %. Weighted by capacity across all batteries.",
-            "type": "number"
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/soc"
           }
-        },
-        "required": [
-          "power",
-          "capacity",
-          "soc"
         ],
-        "type": "object"
-      },
-      "BatteryForecast": {
-        "description": "Projected home battery charge levels based on the solar and price forecast.",
-        "properties": {
-          "highest": {
-            "$ref": "#/components/schemas/BatteryForecastPoint"
-          },
-          "lowest": {
-            "$ref": "#/components/schemas/BatteryForecastPoint"
+        "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/docs/features/battery#battery-boost"
         },
-        "type": "object"
-      },
-      "BatteryForecastPoint": {
-        "description": "A projected home battery charge level at a point in time.",
-        "properties": {
-          "limit": {
-            "description": "The projection hits the upper or lower battery limit.",
-            "type": "boolean"
-          },
-          "soc": {
-            "description": "Projected charge level in %.",
-            "type": "number"
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "time": {
-            "description": "Time of the projected charge level.",
-            "format": "date-time",
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/enable"
           }
-        },
-        "required": [
-          "soc",
-          "time"
         ],
-        "type": "object"
-      },
-      "BatteryMeter": {
-        "description": "Measurement data of a single home battery meter.",
-        "properties": {
-          "capacity": {
-            "description": "Battery capacity in kWh.",
-            "type": "number"
-          },
-          "controllable": {
-            "description": "Battery supports external control of its operation mode.",
-            "type": "boolean"
-          },
-          "currents": {
-            "description": "Current per phase in A.",
-            "items": {
-              "type": "number"
-            },
-            "type": "array"
-          },
-          "energy": {
-            "description": "Total energy in kWh.",
-            "type": "number"
-          },
-          "icon": {
-            "description": "Meter icon name for UI display.",
-            "type": "string"
-          },
-          "name": {
-            "description": "Unique device name of the meter.",
-            "type": "string"
-          },
-          "power": {
-            "description": "Current power in W.",
-            "type": "number"
-          },
-          "powers": {
-            "description": "Power per phase in W.",
-            "items": {
-              "type": "number"
-            },
-            "type": "array"
-          },
-          "returnEnergy": {
-            "description": "Total exported energy in kWh.",
-            "type": "number"
-          },
-          "soc": {
-            "description": "Charge level in %.",
-            "type": "number"
-          },
-          "title": {
-            "description": "Meter title for UI display.",
-            "type": "string"
+        "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/docs/features/battery#battery-boost"
         },
-        "required": [
-          "capacity",
-          "controllable",
-          "power",
-          "soc"
-        ],
-        "type": "object"
-      },
-      "BatteryMode": {
-        "description": "Battery operation mode.",
-        "enum": [
-          "unknown",
-          "normal",
-          "hold",
-          "charge",
-          "holdcharge"
+        "tags": [
+          "loadpoints"
         ],
-        "type": "string"
-      },
-      "Certificate": {
-        "description": "A TLS certificate key pair.",
-        "properties": {
-          "private": {
-            "description": "Private key in PEM format. Redacted.",
-            "type": "string"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "public": {
-            "description": "Public certificate in PEM format.",
-            "type": "string"
+          {
+            "$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/docs/reference/configuration/loadpoints"
         },
-        "required": [
-          "public",
-          "private"
+        "tags": [
+          "loadpoints"
         ],
-        "type": "object"
-      },
-      "ChangePassword": {
-        "properties": {
-          "current": {
-            "$ref": "#/components/schemas/Password"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "new": {
-            "$ref": "#/components/schemas/Password"
+          {
+            "$ref": "#/components/parameters/delay"
           }
-        },
-        "type": "object"
-      },
-      "ChargeMode": {
-        "description": "Charging mode.",
-        "enum": [
-          "off",
-          "now",
-          "minpv",
-          "pv"
         ],
-        "type": "string"
-      },
-      "ChargerStatusReason": {
-        "description": "Reason why the charger is waiting.",
-        "enum": [
-          "unknown",
-          "waitingforauthorization",
-          "disconnectrequired"
+        "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/docs/reference/configuration/loadpoints#threshold-1"
+        },
+        "tags": [
+          "loadpoints"
         ],
-        "type": "string"
-      },
-      "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"
-            }
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "type": "object"
+          {
+            "$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/docs/reference/configuration/loadpoints#delay"
         },
-        "type": "array"
-      },
-      "Circuit": {
-        "description": "A load management circuit limiting power and current of its assigned loadpoints.",
-        "properties": {
-          "current": {
-            "description": "Current in A.",
-            "type": "number"
-          },
-          "icon": {
-            "description": "Circuit icon name for UI display.",
-            "type": "string"
-          },
-          "maxCurrent": {
-            "description": "Maximum allowed current in A.",
-            "type": "number"
-          },
-          "maxPower": {
-            "description": "Maximum allowed power in W.",
-            "type": "number"
-          },
-          "parent": {
-            "description": "Name of the parent circuit.",
-            "type": "string"
-          },
-          "power": {
-            "description": "Current power in W.",
-            "type": "number"
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "title": {
-            "description": "Circuit title for UI display.",
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/delay"
           }
-        },
-        "required": [
-          "power"
         ],
-        "type": "object"
-      },
-      "Currency": {
-        "description": "Currency in ISO 4217 format.",
-        "enum": [
-          "AUD",
-          "BGN",
-          "BRL",
-          "CAD",
-          "CHF",
-          "CNY",
-          "CZK",
-          "EUR",
-          "GBP",
-          "HUF",
-          "ILS",
-          "JPY",
-          "NZD",
-          "NOK",
-          "PLN",
-          "RON",
-          "USD",
-          "DKK",
-          "SEK",
-          "ZAR",
-          "TRY",
-          "MYR"
-        ],
-        "type": "string"
-      },
-      "Current": {
-        "description": "Electric current in A",
-        "example": 16,
-        "minimum": 0,
-        "type": "number"
-      },
-      "Delay": {
-        "description": "Duration in seconds.",
-        "example": 60,
-        "type": "integer"
-      },
-      "DeviceColorEntry": {
-        "description": "Color assigned to a device for consistent UI display.",
-        "properties": {
-          "color": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
+        "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/docs/reference/configuration/loadpoints#threshold"
         },
-        "required": [
-          "title",
-          "color"
+        "tags": [
+          "loadpoints"
         ],
-        "type": "object"
-      },
-      "Eebus": {
-        "description": "EEBus integration configuration and status.",
-        "properties": {
-          "config": {
-            "$ref": "#/components/schemas/EebusConfig"
-          },
-          "status": {
-            "$ref": "#/components/schemas/EebusStatus"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "yamlSource": {
-            "description": "Source of the configuration, evcc.yaml file or database.",
-            "enum": [
-              "file",
-              "db"
-            ],
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/threshold"
           }
-        },
-        "type": "object"
-      },
-      "EebusConfig": {
-        "description": "EEBus integration configuration.",
-        "properties": {
-          "certificate": {
-            "$ref": "#/components/schemas/Certificate"
-          },
-          "interfaces": {
-            "description": "Network interfaces the EEBus service uses.",
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "port": {
-            "description": "Port the EEBus service listens on.",
-            "type": "number"
-          },
-          "shipid": {
-            "description": "SHIP id.",
-            "type": "string"
-          },
-          "uri": {
-            "description": "URI the EEBus service listens on.",
-            "type": "string"
+        ],
+        "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/docs/features/limit"
         },
-        "required": [
-          "port",
-          "shipid"
+        "tags": [
+          "loadpoints"
         ],
-        "type": "object"
-      },
-      "EebusStatus": {
-        "description": "EEBus runtime status.",
-        "properties": {
-          "qr": {
-            "description": "QR code payload for pairing.",
-            "type": "string"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "ski": {
-            "description": "SKI (subject key identifier) used for pairing.",
-            "type": "string"
+          {
+            "$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/docs/features/limit"
         },
-        "required": [
-          "ski"
+        "tags": [
+          "loadpoints"
         ],
-        "type": "object"
-      },
-      "Energy": {
-        "description": "Energy in kWh",
-        "example": 25.5,
-        "minimum": 0,
-        "type": "number"
-      },
-      "EnergyByDay": {
-        "description": "Expected solar production energy of a day.",
-        "properties": {
-          "complete": {
-            "description": "Forecast data covers the whole day.",
-            "type": "boolean"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "energy": {
-            "description": "Expected production energy in kWh.",
-            "type": "number"
+          {
+            "$ref": "#/components/parameters/soc"
           }
-        },
-        "required": [
-          "energy",
-          "complete"
         ],
-        "type": "object"
-      },
-      "FatalError": {
-        "description": "A fatal startup error.",
-        "properties": {
-          "class": {
-            "description": "Device class the error originates from, like meter or charger.",
-            "type": "string"
+        "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"
           },
-          "device": {
-            "description": "Name of the device that caused the error.",
-            "type": "string"
+          {
+            "$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"
           },
-          "error": {
-            "description": "Error message.",
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/current"
+          }
+        ],
+        "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/docs/features/solar-charging"
         },
-        "required": [
-          "error"
+        "tags": [
+          "loadpoints"
         ],
-        "type": "object"
-      },
-      "Forecast": {
-        "description": "Price, CO₂ and solar production forecasts.",
-        "properties": {
-          "co2": {
-            "description": "CO₂ emission forecast in g/kWh per time slot.",
-            "items": {
-              "$ref": "#/components/schemas/ForecastSlot"
-            },
-            "type": "array"
-          },
-          "feedin": {
-            "description": "Feed-in rate forecast. Rate per kWh in the configured currency per time slot.",
-            "items": {
-              "$ref": "#/components/schemas/ForecastSlot"
-            },
-            "type": "array"
-          },
-          "grid": {
-            "description": "Grid price forecast. Price per kWh in the configured currency per time slot.",
-            "items": {
-              "$ref": "#/components/schemas/ForecastSlot"
-            },
-            "type": "array"
-          },
-          "planner": {
-            "description": "Charging cost forecast used by the plan optimizer per time slot.",
-            "items": {
-              "$ref": "#/components/schemas/ForecastSlot"
-            },
-            "type": "array"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "solar": {
-            "$ref": "#/components/schemas/SolarDetails"
+          {
+            "$ref": "#/components/parameters/mode"
           }
-        },
-        "type": "object"
-      },
-      "ForecastSlot": {
-        "description": "A forecast value for a time slot.",
-        "properties": {
-          "end": {
-            "description": "End of the time slot.",
-            "format": "date-time",
-            "type": "string"
-          },
-          "start": {
-            "description": "Start of the time slot.",
-            "format": "date-time",
-            "type": "string"
-          },
-          "value": {
-            "description": "Forecast value of the time slot. Unit depends on the forecast type.",
-            "type": "number"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "$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/docs/reference/configuration/loadpoints#phases"
         },
-        "required": [
-          "start",
-          "end",
-          "value"
+        "tags": [
+          "loadpoints"
         ],
-        "type": "object"
-      },
-      "GenericConfigStatus": {
-        "description": "Configuration and runtime status of an integration. Structure depends on configuration.",
-        "properties": {
-          "config": {
-            "description": "Static configuration."
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "status": {
-            "description": "Runtime status."
+          {
+            "$ref": "#/components/parameters/phases"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
           },
-          "yamlSource": {
-            "description": "Source of the configuration, evcc.yaml file or database.",
-            "enum": [
-              "file",
-              "db"
-            ],
-            "type": "string"
+          "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/docs/features/plans"
         },
-        "type": "object"
-      },
-      "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"
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "allOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "planId": {
+                              "$ref": "#/components/schemas/Id"
+                            }
+                          }
+                        },
+                        {
+                          "$ref": "#/components/schemas/PlanRates"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
             }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "Hems": {
-        "description": "Home energy management system integration.",
-        "properties": {
-          "config": {
-            "$ref": "#/components/schemas/HemsConfig"
-          },
-          "status": {
-            "$ref": "#/components/schemas/HemsStatus"
-          },
-          "yamlSource": {
-            "description": "Source of the configuration, evcc.yaml file or database.",
-            "enum": [
-              "file",
-              "db"
-            ],
-            "type": "string"
           }
+        }
+      }
+    },
+    "/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/docs/features/plans"
         },
-        "type": "object"
-      },
-      "HemsConfig": {
-        "description": "Home energy management system configuration.",
-        "properties": {
-          "configured": {
-            "description": "A home energy management system is configured.",
-            "type": "boolean"
+        "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/docs/features/plans"
         },
-        "required": [
-          "configured"
+        "tags": [
+          "loadpoints"
         ],
-        "type": "object"
-      },
-      "HemsStatus": {
-        "description": "Current external limits imposed by the home energy management system.",
-        "properties": {
-          "curtailed": {
-            "description": "Allowed feed-in in %. Values below 100 mean production is curtailed.",
-            "type": "number"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "dimmed": {
-            "description": "Consumption is currently limited.",
-            "type": "boolean"
-          },
-          "maxConsumptionPower": {
-            "description": "Maximum allowed consumption power in W.",
-            "type": "number"
+          {
+            "$ref": "#/components/parameters/energy"
           },
-          "maxProductionPower": {
-            "description": "Maximum allowed production power in W.",
-            "type": "number"
+          {
+            "$ref": "#/components/parameters/timestamp"
           }
-        },
-        "type": "object"
-      },
-      "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",
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "$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://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List"
+          "url": "https://docs.evcc.io/en/docs/features/plans"
         },
-        "type": "string"
-      },
-      "Id": {
-        "description": "Loadpoint index starting at 1.",
-        "example": 1,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "InfluxConfig": {
-        "description": "InfluxDB integration configuration.",
-        "properties": {
-          "database": {
-            "description": "Database name (InfluxDB 1.x) or bucket (InfluxDB 2.x).",
-            "type": "string"
-          },
-          "insecure": {
-            "description": "Skip TLS certificate verification.",
-            "type": "boolean"
-          },
-          "org": {
-            "description": "Organization (InfluxDB 2.x).",
-            "type": "string"
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "password": {
-            "description": "Password (InfluxDB 1.x). Redacted.",
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/soc"
           },
-          "token": {
-            "description": "Access token (InfluxDB 2.x). Redacted.",
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/weekdays"
           },
-          "url": {
-            "description": "InfluxDB server URL.",
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/hourMinuteTime"
           },
-          "user": {
-            "description": "Username (InfluxDB 1.x).",
-            "type": "string"
+          {
+            "$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/docs/features/plans"
         },
-        "required": [
-          "url",
-          "database",
-          "org"
+        "tags": [
+          "loadpoints"
         ],
-        "type": "object"
-      },
-      "Loadpoint": {
-        "description": "A charging location with a charger, an optional dedicated meter and an optional vehicle.",
-        "properties": {
-          "batteryBoost": {
-            "description": "Battery boost is active. When enabled, home battery power is used for fast charging.",
-            "type": "boolean"
-          },
-          "batteryBoostLimit": {
-            "description": "SoC limit for battery boost in %.",
-            "type": "number"
-          },
-          "chargeCurrents": {
-            "description": "Charging current per phase in A.",
-            "items": {
-              "type": "number"
-            },
-            "type": "array"
-          },
-          "chargeDuration": {
-            "description": "Duration of the current charging session in seconds.",
-            "type": "number"
-          },
-          "chargePower": {
-            "description": "Current charging power in W.",
-            "type": "number"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "chargeRemainingDuration": {
-            "description": "Estimated remaining charging time in seconds.",
-            "type": "number"
+          {
+            "$ref": "#/components/parameters/soc"
           },
-          "chargeRemainingEnergy": {
-            "description": "Estimated remaining energy in kWh.",
-            "type": "number"
+          {
+            "$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/docs/features/plans"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "chargeTotalImport": {
-            "description": "Total energy imported by the charge meter in kWh.",
-            "type": "number"
+          {
+            "$ref": "#/components/parameters/energy"
           },
-          "chargeVoltages": {
-            "description": "Charging voltage per phase in V.",
-            "items": {
-              "type": "number"
-            },
-            "type": "array"
+          {
+            "$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/docs/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": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "$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/docs/reference/configuration/loadpoints#priority"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "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.",
-            "nullable": true,
-            "type": "string"
+          {
+            "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/docs/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/docs/features/dynamic-prices"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "chargerPhases1p3p": {
-            "description": "Charger supports automatic switching between 1-phase and 3-phase charging.",
-            "type": "boolean"
+          {
+            "$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"
           },
-          "chargerSinglePhase": {
-            "description": "Charger is physically connected with a single phase.",
-            "type": "boolean"
+          {
+            "$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/docs/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/docs/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/docs/features/vehicle"
+        },
+        "tags": [
+          "loadpoints"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/id"
           },
-          "chargerStatusReason": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/ChargerStatusReason"
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "vehicle": {
+                          "$ref": "#/components/schemas/VehicleTitle"
+                        }
+                      }
+                    }
+                  }
+                }
               }
-            ],
-            "description": "Reason why the charger is waiting, like a pending authorization or a required disconnect.",
-            "nullable": true
-          },
-          "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"
-          },
-          "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"
-          },
-          "effectivePlanStrategy": {
-            "$ref": "#/components/schemas/PlanStrategy"
-          },
-          "effectivePlanTime": {
-            "description": "Target time of the currently applied charging plan.",
-            "format": "date-time",
-            "nullable": true,
-            "type": "string"
-          },
-          "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"
-          },
-          "minSocNotReached": {
-            "description": "Vehicle SoC is below the configured minimum SoC.",
-            "type": "boolean"
-          },
-          "mode": {
-            "$ref": "#/components/schemas/ChargeMode"
-          },
-          "name": {
-            "description": "Unique loadpoint identifier used in API routes and configuration.",
-            "type": "string"
-          },
-          "offeredCurrent": {
-            "description": "Current offered to the vehicle in A.",
-            "type": "number"
-          },
-          "phaseAction": {
-            "$ref": "#/components/schemas/PhaseAction"
-          },
-          "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.",
-            "items": {
-              "$ref": "#/components/schemas/Rate"
-            },
-            "nullable": true,
-            "type": "array"
-          },
-          "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"
-          },
-          "planProjectedEnd": {
-            "description": "Projected end of the charging plan. End of the last planned slot.",
-            "format": "date-time",
-            "nullable": true,
-            "type": "string"
-          },
-          "planProjectedStart": {
-            "description": "Projected start of the charging plan. Start of the earliest planned slot.",
-            "format": "date-time",
-            "nullable": true,
-            "type": "string"
-          },
-          "planStrategy": {
-            "$ref": "#/components/schemas/PlanStrategy"
-          },
-          "planTime": {
-            "description": "Target time of the charging plan.",
-            "format": "date-time",
-            "nullable": true,
-            "type": "string"
-          },
-          "priority": {
-            "description": "Priority for surplus distribution. Higher number means higher priority.",
-            "type": "number"
-          },
-          "pvAction": {
-            "$ref": "#/components/schemas/PvAction"
-          },
-          "pvRemaining": {
-            "description": "Remaining time until the pending charge start or stop action executes, in seconds.",
-            "type": "number"
-          },
-          "sessionCo2PerKWh": {
-            "description": "Average CO₂ emissions of the current charging session in g/kWh.",
-            "nullable": true,
-            "type": "number"
-          },
-          "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.",
-            "nullable": true,
-            "type": "number"
-          },
-          "sessionPricePerKWh": {
-            "description": "Average energy price of the current charging session per kWh in the configured currency.",
-            "nullable": true,
-            "type": "number"
-          },
-          "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.",
-            "nullable": true,
-            "type": "number"
+            }
+          }
+        }
+      }
+    },
+    "/prioritysoc/{soc}": {
+      "post": {
+        "operationId": "setPrioritySoc",
+        "summary": "Set battery priority SoC",
+        "description": "Set battery priority SoC.",
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/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/docs/reference/configuration/site#residualpower"
+        },
+        "tags": [
+          "battery"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/power"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NumberResult"
+          }
+        }
+      }
+    },
+    "/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/docs/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/docs/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"
+              ]
+            }
           },
-          "smartCostNextStart": {
-            "description": "Start of the next fast charging period with cheap or clean grid energy.",
-            "format": "date-time",
-            "nullable": true,
-            "type": "string"
+          {
+            "name": "lang",
+            "in": "query",
+            "description": "Language (defaults to accept header)",
+            "schema": {
+              "type": "string",
+              "example": "de"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "$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/docs/features/sessions"
+        },
+        "tags": [
+          "sessions"
+        ],
+        "parameters": [
+          {
+            "name": "format",
+            "in": "query",
+            "description": "Response format (default json)",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "csv"
+              ]
+            }
           },
-          "smartFeedInPriorityActive": {
-            "description": "Charging pause for prioritized feed-in is currently active.",
-            "type": "boolean"
+          {
+            "name": "lang",
+            "in": "query",
+            "description": "Language (defaults to accept header)",
+            "schema": {
+              "type": "string",
+              "example": "de"
+            }
           },
-          "smartFeedInPriorityLimit": {
-            "description": "Feed-in rate limit above which charging is paused.",
-            "nullable": true,
-            "type": "number"
+          {
+            "name": "month",
+            "in": "query",
+            "description": "Month filter",
+            "schema": {
+              "type": "integer",
+              "example": 2,
+              "minimum": 1,
+              "maximum": 12
+            }
           },
-          "smartFeedInPriorityNextStart": {
-            "description": "Start of the next charging pause for prioritized feed-in.",
-            "format": "date-time",
-            "nullable": true,
-            "type": "string"
+          {
+            "name": "year",
+            "in": "query",
+            "description": "Year filter",
+            "schema": {
+              "type": "integer",
+              "example": 2025
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "$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/docs/reference/configuration/telemetry"
+        },
+        "tags": [
+          "system"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/enable"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/BooleanResult"
           },
-          "title": {
-            "description": "Loadpoint title for UI display.",
-            "type": "string"
+          "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.",
+        "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/docs/reference/configuration/log"
+        },
+        "security": [
+          {
+            "cookieAuth": []
           },
-          "ui": {
-            "$ref": "#/components/schemas/LoadpointUi"
+          {
+            "bearerAuth": []
+          }
+        ],
+        "tags": [
+          "system"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/logAreas"
           },
-          "vehicleClimaterActive": {
-            "description": "Climater of the connected vehicle is active.",
-            "nullable": true,
-            "type": "boolean"
+          {
+            "$ref": "#/components/parameters/logLevel"
           },
-          "vehicleDetectionActive": {
-            "description": "Automatic vehicle detection is running.",
-            "type": "boolean"
+          {
+            "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": "object",
+                  "properties": {
+                    "result": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                }
+              },
+              "text/plain": {
+                "schema": {
+                  "description": "Download txt-file",
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
           },
-          "vehicleLimitSoc": {
-            "description": "SoC limit configured in the vehicle itself, in %.",
-            "type": "number"
+          "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": []
           },
-          "vehicleName": {
-            "description": "Unique name of the connected vehicle. Empty for guest vehicles.",
-            "type": "string"
+          {
+            "bearerAuth": []
+          }
+        ],
+        "tags": [
+          "system"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "$ref": "#/components/schemas/LogAreas"
+                    }
+                  }
+                }
+              }
+            }
           },
-          "vehicleOdometer": {
-            "description": "Odometer reading of the connected vehicle in km.",
-            "type": "number"
+          "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": []
           },
-          "vehicleRange": {
-            "description": "Range of the connected vehicle in km.",
-            "type": "number"
+          {
+            "bearerAuth": []
+          }
+        ],
+        "tags": [
+          "system"
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/SuccessResult"
           },
-          "vehicleSoc": {
-            "description": "Charge level of the connected vehicle in %. Temperature in degrees for heating devices.",
-            "type": "number"
+          "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": []
           },
-          "vehicleTitle": {
-            "description": "Title of the connected vehicle for UI display.",
-            "type": "string"
+          {
+            "bearerAuth": []
+          }
+        ],
+        "tags": [
+          "system"
+        ],
+        "responses": {
+          "204": {
+            "$ref": "#/components/responses/BlankResponse"
           },
-          "vehicleWelcomeActive": {
-            "description": "A short welcome charge is active to enable vehicle communication.",
-            "type": "boolean"
+          "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/docs/devices/tariffs"
         },
-        "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",
-          "effectivePlanId",
-          "effectivePlanSoc",
-          "effectivePlanTime",
-          "effectivePlanStrategy",
-          "effectivePriority",
-          "enableDelay",
-          "enableThreshold",
-          "enabled",
-          "limitEnergy",
-          "limitSoc",
-          "maxCurrent",
-          "minCurrent",
-          "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"
+        "tags": [
+          "tariffs"
         ],
-        "type": "object"
-      },
-      "LoadpointName": {
-        "example": "Garage",
+        "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": {
+                    "result": {
+                      "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/docs/reference/configuration/loadpoints#title"
+          "url": "https://docs.evcc.io/en/docs/features/limits"
         },
-        "type": "string"
-      },
-      "LoadpointUi": {
-        "description": "Display-only UI settings of a loadpoint.",
-        "properties": {
-          "maxTemp": {
-            "description": "Upper bound of the temperature scale for heating devices, in degrees.",
-            "type": "number"
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
           },
-          "minTemp": {
-            "description": "Lower bound of the temperature scale for heating devices, in degrees.",
-            "type": "number"
+          {
+            "$ref": "#/components/parameters/soc"
           }
-        },
-        "required": [
-          "minTemp",
-          "maxTemp"
         ],
-        "type": "object"
-      },
-      "LogArea": {
+        "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/docs/reference/configuration/log#levels"
+          "url": "https://docs.evcc.io/en/docs/features/limits"
         },
-        "type": "string"
-      },
-      "LogAreas": {
-        "example": [
-          "lp-1",
-          "site",
-          "db"
+        "tags": [
+          "vehicles"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          },
+          {
+            "$ref": "#/components/parameters/soc"
+          }
         ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/SocResult"
+          }
+        }
+      }
+    },
+    "/vehicles/{name}/plan/repeating": {
+      "post": {
+        "operationId": "updateVehicleRepeatingPlans",
+        "summary": "Update repeating plans",
+        "description": "Updates the repeating charging plan.",
         "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/reference/configuration/log#levels"
-        },
-        "items": {
-          "$ref": "#/components/schemas/LogArea"
+          "url": "https://docs.evcc.io/en/docs/features/plans"
         },
-        "type": "array"
-      },
-      "LogLevel": {
-        "enum": [
-          "FATAL",
-          "ERROR",
-          "WARN",
-          "INFO",
-          "DEBUG",
-          "TRACE"
+        "tags": [
+          "vehicles"
         ],
-        "example": "DEBUG",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/reference/configuration/log#log"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/RepeatingPlan"
+                }
+              }
+            }
+          }
         },
-        "type": "string"
-      },
-      "MessagingEvent": {
-        "description": "A configured notification message.",
-        "properties": {
-          "disabled": {
-            "description": "Notifications for this event are disabled.",
-            "type": "boolean"
-          },
-          "msg": {
-            "description": "Message body template.",
-            "type": "string"
-          },
-          "title": {
-            "description": "Message title template.",
-            "type": "string"
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "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/docs/features/plans"
         },
-        "required": [
-          "title",
-          "msg",
-          "disabled"
+        "tags": [
+          "vehicles"
         ],
-        "type": "object"
-      },
-      "MessagingEvents": {
-        "additionalProperties": false,
-        "description": "Configured notification messages, keyed by event type.",
-        "properties": {
-          "asleep": {
-            "$ref": "#/components/schemas/MessagingEvent"
-          },
-          "connect": {
-            "$ref": "#/components/schemas/MessagingEvent"
-          },
-          "disconnect": {
-            "$ref": "#/components/schemas/MessagingEvent"
-          },
-          "guest": {
-            "$ref": "#/components/schemas/MessagingEvent"
-          },
-          "planoverrun": {
-            "$ref": "#/components/schemas/MessagingEvent"
-          },
-          "soc": {
-            "$ref": "#/components/schemas/MessagingEvent"
-          },
-          "start": {
-            "$ref": "#/components/schemas/MessagingEvent"
-          },
-          "stop": {
-            "$ref": "#/components/schemas/MessagingEvent"
+        "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/docs/features/plans"
         },
-        "required": [
-          "start",
-          "stop",
-          "connect",
-          "disconnect",
-          "soc",
-          "guest",
-          "asleep",
-          "planoverrun"
+        "tags": [
+          "vehicles"
         ],
-        "type": "object"
-      },
-      "Meter": {
-        "description": "Measurement data of a single meter.",
-        "properties": {
-          "currents": {
-            "description": "Current per phase in A.",
-            "items": {
-              "type": "number"
-            },
-            "type": "array"
-          },
-          "energy": {
-            "description": "Total energy in kWh.",
-            "type": "number"
-          },
-          "icon": {
-            "description": "Meter icon name for UI display.",
-            "type": "string"
-          },
-          "name": {
-            "description": "Unique device name of the meter.",
-            "type": "string"
-          },
-          "power": {
-            "description": "Current power in W.",
-            "type": "number"
-          },
-          "powers": {
-            "description": "Power per phase in W.",
-            "items": {
-              "type": "number"
-            },
-            "type": "array"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
           },
-          "returnEnergy": {
-            "description": "Total exported energy in kWh.",
-            "type": "number"
+          {
+            "$ref": "#/components/parameters/soc"
           },
-          "title": {
-            "description": "Meter title for UI display.",
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/timestamp"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "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/docs/features/plans"
         },
-        "required": [
-          "power"
+        "tags": [
+          "vehicles"
         ],
-        "type": "object"
-      },
-      "ModbusBaudrate": {
-        "description": "Serial baud rate.",
-        "enum": [
-          1200,
-          9600,
-          19200,
-          38400,
-          57600,
-          115200
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/vehicleName"
+          }
         ],
-        "type": "number"
-      },
-      "ModbusComset": {
-        "description": "Serial communication parameters.",
-        "enum": [
-          "8N1",
-          "8E1",
-          "8N2"
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PlanStrategy"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "$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"
         ],
-        "type": "string"
-      },
-      "ModbusProxy": {
-        "description": "A Modbus proxy forwarding requests to a physical device.",
-        "properties": {
-          "port": {
-            "description": "Port the proxy listens on.",
-            "type": "number"
-          },
-          "readonly": {
-            "$ref": "#/components/schemas/ModbusProxyReadonly"
+        "security": [
+          {
+            "cookieAuth": []
           },
-          "settings": {
-            "$ref": "#/components/schemas/ModbusProxySettings"
+          {
+            "bearerAuth": []
           }
-        },
-        "required": [
-          "port",
-          "readonly",
-          "settings"
         ],
-        "type": "object"
-      },
-      "ModbusProxyReadonly": {
-        "description": "How the Modbus proxy handles write requests.",
-        "enum": [
-          "false",
-          "true",
-          "deny"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/adminPassword"
+          }
         ],
-        "type": "string"
-      },
-      "ModbusProxySettings": {
-        "description": "Connection settings of a Modbus device.",
-        "properties": {
-          "baudrate": {
-            "$ref": "#/components/schemas/ModbusBaudrate"
+        "responses": {
+          "200": {
+            "description": "SQLite database file",
+            "content": {
+              "application/octet-stream": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
           },
-          "comset": {
-            "$ref": "#/components/schemas/ModbusComset"
+          "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": []
           },
-          "device": {
-            "description": "Serial device path.",
-            "type": "string"
+          {
+            "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"
           },
-          "rtu": {
-            "description": "Use RTU protocol over TCP.",
-            "type": "boolean"
+          "400": {
+            "description": "Invalid file or missing fields"
           },
-          "uri": {
-            "description": "Device address for TCP connections.",
-            "type": "string"
+          "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"
+                  }
+                }
+              }
+            }
           }
         },
-        "type": "object"
-      },
-      "MqttConfig": {
-        "description": "MQTT integration configuration.",
-        "properties": {
-          "broker": {
-            "description": "Broker address.",
-            "type": "string"
+        "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"
+            }
           },
-          "caCert": {
-            "description": "CA certificate for TLS connections.",
-            "type": "string"
+          {
+            "name": "to",
+            "in": "query",
+            "description": "End time (RFC3339)",
+            "schema": {
+              "type": "string",
+              "format": "date-time",
+              "example": "2026-07-02T00:00:00Z"
+            }
           },
-          "clientCert": {
-            "description": "Client certificate for TLS connections.",
-            "type": "string"
+          {
+            "name": "aggregate",
+            "in": "query",
+            "description": "Aggregation interval. Examples: 15m, 1h, day, month",
+            "schema": {
+              "type": "string",
+              "default": "15m",
+              "example": "1h"
+            }
           },
-          "clientID": {
-            "description": "MQTT client id.",
-            "type": "string"
+          {
+            "name": "grouped",
+            "in": "query",
+            "description": "Group results by loadpoint",
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "example": false
+            }
           },
-          "clientKey": {
-            "description": "Client key for TLS connections.",
-            "type": "string"
+          {
+            "name": "group",
+            "in": "query",
+            "description": "Filter by entity group",
+            "schema": {
+              "type": "string",
+              "example": "battery",
+              "enum": [
+                "forecast",
+                "battery",
+                "grid",
+                "pv",
+                "home",
+                "loadpoint",
+                "meter",
+                "consumer"
+              ]
+            }
           },
-          "insecure": {
-            "description": "Skip TLS certificate verification.",
-            "type": "boolean"
+          {
+            "name": "name",
+            "in": "query",
+            "description": "Filter by entity name",
+            "schema": {
+              "type": "string",
+              "example": "db:8"
+            }
           },
-          "password": {
-            "description": "Broker password. Redacted.",
-            "type": "string"
+          {
+            "name": "title",
+            "in": "query",
+            "description": "Filter by entity title",
+            "schema": {
+              "type": "string",
+              "example": "Battery"
+            }
           },
-          "topic": {
-            "description": "Root topic all values are published under.",
-            "type": "string"
+          {
+            "name": "format",
+            "in": "query",
+            "description": "Response format",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "json",
+                "csv"
+              ],
+              "default": "json",
+              "example": "json"
+            }
           },
-          "user": {
-            "description": "Broker username.",
-            "type": "string"
+          {
+            "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"
+            }
           }
-        },
-        "required": [
-          "broker",
-          "topic"
         ],
-        "type": "object"
-      },
-      "Network": {
-        "description": "Network configuration.",
-        "properties": {
-          "externalUrl": {
-            "description": "Externally reachable URL.",
-            "type": "string"
-          },
-          "host": {
-            "description": "Hostname.",
-            "type": "string"
-          },
-          "internalUrl": {
-            "description": "URL in the local network.",
-            "type": "string"
-          },
-          "port": {
-            "description": "HTTP port.",
-            "type": "number"
+        "responses": {
+          "200": {
+            "description": "Energy history data",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              },
+              "text/csv": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
           },
-          "schema": {
-            "description": "URL schema, http or https.",
-            "type": "string"
+          "400": {
+            "description": "Invalid parameters or database offline"
           }
-        },
-        "required": [
-          "host",
-          "port"
-        ],
-        "type": "object"
-      },
-      "Ocpp": {
-        "description": "OCPP server configuration and status.",
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "ChangePassword": {
+        "type": "object",
         "properties": {
-          "config": {
-            "$ref": "#/components/schemas/OcppConfig"
+          "current": {
+            "$ref": "#/components/schemas/Password"
           },
-          "status": {
-            "$ref": "#/components/schemas/OcppStatus"
+          "new": {
+            "$ref": "#/components/schemas/Password"
           }
-        },
-        "required": [
-          "config",
-          "status"
-        ],
-        "type": "object"
+        }
       },
-      "OcppConfig": {
-        "description": "OCPP server configuration.",
-        "properties": {
-          "port": {
-            "description": "Port the OCPP server listens on.",
-            "type": "number"
+      "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"
+            }
           }
-        },
-        "required": [
-          "port"
-        ],
-        "type": "object"
-      },
-      "OcppConnectionStatus": {
-        "description": "Connection status of an OCPP station.",
-        "enum": [
-          "unknown",
-          "configured",
-          "connected"
-        ],
-        "type": "string"
+        }
       },
-      "OcppForwarder": {
-        "description": "OCPP forwarder rules and upstream connection status.",
-        "properties": {
-          "config": {
-            "description": "Static configuration.",
-            "items": {
-              "$ref": "#/components/schemas/OcppForwarderRule"
+      "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"
             },
-            "type": "array"
-          },
-          "status": {
-            "description": "Runtime status.",
-            "items": {
-              "$ref": "#/components/schemas/OcppForwarderSession"
+            "gridPower": {
+              "type": "number",
+              "description": "Grid power in watts"
             },
-            "type": "array"
-          },
-          "yamlSource": {
-            "description": "Source of the configuration, evcc.yaml file or database.",
-            "enum": [
-              "file",
-              "db"
-            ],
-            "type": "string"
+            "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": "object"
+        "type": "string",
+        "example": "Europe/Berlin"
       },
-      "OcppForwarderRule": {
-        "description": "A rule forwarding an OCPP station to an upstream backend.",
-        "properties": {
-          "caCert": {
-            "description": "CA certificate for TLS connections.",
-            "type": "string"
-          },
-          "insecure": {
-            "description": "Skip TLS certificate verification.",
-            "type": "boolean"
-          },
-          "password": {
-            "description": "Password for upstream authentication. Redacted.",
-            "type": "string"
-          },
-          "readOnly": {
-            "description": "Only forward read operations to the station.",
-            "type": "boolean"
-          },
-          "stationId": {
-            "description": "Station id to forward.",
-            "type": "string"
-          },
-          "upstreamStationId": {
-            "description": "Station id used towards the upstream backend.",
-            "type": "string"
-          },
-          "upstreamUrl": {
-            "description": "URL of the upstream OCPP backend.",
-            "type": "string"
-          },
-          "username": {
-            "description": "Username for upstream authentication.",
-            "type": "string"
-          }
+      "Id": {
+        "description": "Loadpoint index starting at 1.",
+        "type": "integer",
+        "example": 1,
+        "minimum": 1
+      },
+      "LoadpointName": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/reference/configuration/loadpoints#title"
         },
-        "required": [
-          "stationId",
-          "upstreamUrl"
-        ],
-        "type": "object"
+        "type": "string",
+        "example": "Garage"
       },
-      "OcppForwarderSession": {
-        "description": "Connection status of an OCPP forwarder rule.",
-        "properties": {
-          "chargerId": {
-            "description": "Charger id.",
-            "type": "string"
-          },
-          "error": {
-            "description": "Last connection error.",
-            "type": "string"
-          },
-          "upstreamConnected": {
-            "description": "Connection to the upstream backend is established.",
-            "type": "boolean"
-          },
-          "upstreamUrl": {
-            "description": "URL of the upstream OCPP backend.",
-            "type": "string"
-          }
+      "LogArea": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/reference/configuration/log#levels"
         },
-        "required": [
-          "chargerId",
-          "upstreamUrl",
-          "upstreamConnected"
-        ],
-        "type": "object"
+        "type": "string"
       },
-      "OcppStationStatus": {
-        "description": "Connection status of an OCPP station.",
-        "properties": {
-          "id": {
-            "description": "Station id.",
-            "type": "string"
-          },
-          "status": {
-            "$ref": "#/components/schemas/OcppConnectionStatus"
-          }
+      "LogAreas": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/reference/configuration/log#levels"
         },
-        "required": [
-          "id",
-          "status"
+        "type": "array",
+        "example": [
+          "lp-1",
+          "site",
+          "db"
         ],
-        "type": "object"
+        "items": {
+          "$ref": "#/components/schemas/LogArea"
+        }
       },
-      "OcppStatus": {
-        "description": "OCPP server status.",
-        "properties": {
-          "externalUrl": {
-            "description": "Externally reachable URL of the OCPP server.",
-            "type": "string"
-          },
-          "stations": {
-            "description": "Connection status per configured station.",
-            "items": {
-              "$ref": "#/components/schemas/OcppStationStatus"
-            },
-            "type": "array"
-          }
+      "LogLevel": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/reference/configuration/log#log"
         },
-        "required": [
-          "stations"
-        ],
-        "type": "object"
+        "type": "string",
+        "example": "DEBUG",
+        "enum": [
+          "FATAL",
+          "ERROR",
+          "WARN",
+          "INFO",
+          "DEBUG",
+          "TRACE"
+        ]
       },
       "Odometer": {
-        "description": "Vehicle odometer reading in kilometers",
         "nullable": true,
-        "type": "number"
+        "type": "number",
+        "description": "Vehicle odometer reading in kilometers"
       },
       "Password": {
         "description": "Admin password",
         "type": "string"
       },
-      "PhaseAction": {
-        "description": "Pending phase switching action in solar mode.",
-        "enum": [
-          "inactive",
-          "scale1p",
-          "scale3p"
-        ],
-        "type": "string"
-      },
       "Phases": {
         "description": "Number of phases. (0: auto, 1: 1-phase, 3: 3-phase)",
+        "type": "string",
+        "example": "3",
         "enum": [
           "0",
           "1",
           "3"
-        ],
-        "example": "3",
-        "type": "string"
+        ]
       },
       "PlanRates": {
+        "type": "object",
         "properties": {
           "duration": {
             "description": "Duration in s",
-            "minimum": 0,
-            "type": "integer"
+            "type": "integer",
+            "minimum": 0
           },
           "plan": {
             "$ref": "#/components/schemas/Rates"
@@ -2082,60 +2513,104 @@
           "power": {
             "$ref": "#/components/schemas/Power"
           }
-        },
-        "type": "object"
-      },
-      "PlanStrategy": {
-        "description": "Charging plan strategy.",
-        "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"
-        ],
-        "type": "object"
+        }
       },
       "Power": {
         "description": "Power in W",
-        "example": 2500,
+        "type": "number",
         "minimum": 0,
-        "type": "number"
+        "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,
-        "type": "integer"
+        "maximum": 100
+      },
+      "Timestamp": {
+        "description": "Timestamp in RFC3339 format",
+        "type": "string",
+        "format": "date-time"
+      },
+      "VehicleName": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/reference/configuration/vehicles#name"
+        },
+        "type": "string",
+        "minLength": 1,
+        "pattern": "[a-zA-Z0-9_.:-]+",
+        "example": "vehicle_1"
+      },
+      "VehicleTitle": {
+        "externalDocs": {
+          "url": "https://docs.evcc.io/en/docs/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"
+        ]
       },
-      "PvAction": {
-        "description": "Pending charge start or stop action in solar mode.",
+      "ChargeMode": {
+        "description": "Charging mode.",
+        "type": "string",
         "enum": [
-          "inactive",
-          "enable",
-          "disable"
-        ],
-        "type": "string"
+          "off",
+          "now",
+          "minpv",
+          "pv"
+        ]
       },
       "Rate": {
         "description": "A time slot with an associated price or emission value.",
+        "type": "object",
         "properties": {
-          "end": {
-            "description": "End of the time slot.",
-            "format": "date-time",
-            "type": "string"
-          },
           "start": {
             "description": "Start of the time slot.",
-            "format": "date-time",
-            "type": "string"
+            "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.",
@@ -2146,3069 +2621,2642 @@
           "start",
           "end",
           "value"
-        ],
-        "type": "object"
-      },
-      "Rates": {
-        "items": {
-          "$ref": "#/components/schemas/Rate"
-        },
-        "type": "array"
-      },
-      "Remote": {
-        "description": "Remote access configuration and connection status.",
-        "properties": {
-          "config": {
-            "$ref": "#/components/schemas/RemoteConfig"
-          },
-          "status": {
-            "$ref": "#/components/schemas/RemoteStatus"
-          },
-          "yamlSource": {
-            "description": "Source of the configuration, evcc.yaml file or database.",
-            "enum": [
-              "file",
-              "db"
-            ],
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "RemoteConfig": {
-        "description": "Remote access configuration.",
-        "properties": {
-          "enabled": {
-            "description": "Remote access is enabled.",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "enabled"
-        ],
-        "type": "object"
-      },
-      "RemoteStatus": {
-        "description": "Remote access connection status.",
-        "properties": {
-          "connected": {
-            "description": "Connection to the remote access server is established.",
-            "type": "boolean"
-          },
-          "lastSeen": {
-            "additionalProperties": {
-              "type": "string"
-            },
-            "description": "Last remote activity per client, keyed by username. RFC3339 timestamps.",
-            "type": "object"
-          },
-          "loginBlocked": {
-            "description": "Remote login attempts are currently blocked by the rate limiter.",
-            "type": "boolean"
-          },
-          "url": {
-            "description": "Remote access URL.",
-            "type": "string"
-          }
-        },
-        "required": [
-          "connected",
-          "loginBlocked"
-        ],
-        "type": "object"
+        ]
       },
-      "RepeatingPlan": {
-        "description": "A repeating charging plan.",
+      "StaticEnergyPlan": {
+        "description": "Charging plan with an energy goal.",
+        "type": "object",
         "properties": {
-          "active": {
-            "description": "Plan is active.",
-            "type": "boolean"
-          },
-          "soc": {
-            "description": "SoC goal in %.",
+          "energy": {
+            "description": "Energy goal in kWh.",
             "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"
-          },
-          "weekdays": {
-            "description": "Weekdays the plan is active. 0 is Sunday, 6 is Saturday.",
-            "items": {
-              "type": "number"
-            },
-            "type": "array"
+            "description": "Target time.",
+            "type": "string",
+            "format": "date-time"
           }
         },
         "required": [
-          "weekdays",
-          "time",
-          "tz",
-          "soc",
-          "active"
-        ],
-        "type": "object"
+          "energy",
+          "time"
+        ]
       },
-      "ShmConfig": {
-        "description": "SMA Home Manager configuration.",
+      "PlanStrategy": {
+        "description": "Charging plan strategy.",
+        "type": "object",
         "properties": {
-          "deviceId": {
-            "description": "SMA device id.",
-            "type": "string"
-          },
-          "deviceSerial": {
-            "description": "SMA device serial.",
-            "type": "string"
+          "continuous": {
+            "description": "Force continuous charging without gaps.",
+            "type": "boolean"
           },
-          "vendorId": {
-            "description": "SMA vendor id.",
-            "type": "string"
+          "precondition": {
+            "description": "Duration of uninterrupted charging directly before the target time, in seconds.",
+            "type": "number"
           }
         },
         "required": [
-          "vendorId",
-          "deviceId"
-        ],
-        "type": "object"
+          "continuous",
+          "precondition"
+        ]
       },
-      "SmartCostType": {
-        "description": "Type of the smart charging limit.",
+      "ChargerStatusReason": {
+        "description": "Reason why the charger is waiting.",
+        "type": "string",
         "enum": [
-          "co2",
-          "pricedynamic",
-          "priceforecast"
-        ],
-        "type": "string"
-      },
-      "Soc": {
-        "description": "SOC in %",
-        "example": 60,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "SolarDetails": {
-        "description": "Solar production forecast.",
-        "properties": {
-          "dayAfterTomorrow": {
-            "$ref": "#/components/schemas/EnergyByDay"
-          },
-          "scale": {
-            "description": "Correction factor applied to the forecast based on past production.",
-            "type": "number"
-          },
-          "timeseries": {
-            "description": "Expected production power over time.",
-            "items": {
-              "$ref": "#/components/schemas/TimeseriesEntry"
-            },
-            "type": "array"
-          },
-          "today": {
-            "$ref": "#/components/schemas/EnergyByDay"
-          },
-          "tomorrow": {
-            "$ref": "#/components/schemas/EnergyByDay"
-          }
-        },
-        "type": "object"
+          "unknown",
+          "waitingforauthorization",
+          "disconnectrequired"
+        ]
       },
-      "Sponsor": {
-        "description": "Sponsorship status.",
-        "properties": {
-          "config": {
-            "description": "Static configuration."
-          },
-          "status": {
-            "$ref": "#/components/schemas/SponsorStatus"
-          },
-          "yamlSource": {
-            "description": "Source of the configuration, evcc.yaml file or database.",
-            "enum": [
-              "file",
-              "db"
-            ],
-            "type": "string"
-          }
-        },
-        "type": "object"
+      "PhaseAction": {
+        "description": "Pending phase switching action in solar mode.",
+        "type": "string",
+        "enum": [
+          "inactive",
+          "scale1p",
+          "scale3p"
+        ]
       },
-      "SponsorStatus": {
-        "description": "Sponsorship status.",
-        "properties": {
-          "expiresAt": {
-            "description": "Expiry time of the sponsor token.",
-            "format": "date-time",
-            "type": "string"
-          },
-          "expiresSoon": {
-            "description": "Sponsor token expires soon.",
-            "type": "boolean"
-          },
-          "name": {
-            "description": "Name of the sponsor.",
-            "type": "string"
-          },
-          "token": {
-            "description": "Sponsor token. Redacted.",
-            "type": "string"
-          }
-        },
-        "type": "object"
+      "PvAction": {
+        "description": "Pending charge start or stop action in solar mode.",
+        "type": "string",
+        "enum": [
+          "inactive",
+          "enable",
+          "disable"
+        ]
       },
-      "State": {
-        "description": "Complete system state as returned by /api/state and pushed via websocket and MQTT. The overall structure is stable, details may change between releases.",
+      "LoadpointUi": {
+        "description": "Display-only UI settings of a loadpoint.",
+        "type": "object",
         "properties": {
-          "apiReady": {
-            "description": "HTTP API is ready to accept requests.",
-            "type": "boolean"
-          },
-          "authDisabled": {
-            "description": "Authentication is disabled.",
-            "type": "boolean"
-          },
-          "authProviders": {
-            "$ref": "#/components/schemas/AuthProviders"
-          },
-          "aux": {
-            "description": "Auxiliary consumption meters. Their power is treated as available for charging.",
-            "items": {
-              "$ref": "#/components/schemas/Meter"
-            },
-            "type": "array"
-          },
-          "auxPower": {
-            "description": "Total power of all auxiliary meters in W.",
+          "minTemp": {
+            "description": "Lower bound of the temperature scale for heating devices, in degrees.",
             "type": "number"
           },
-          "availableVersion": {
-            "description": "Latest available evcc version.",
+          "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"
           },
-          "battery": {
-            "$ref": "#/components/schemas/Battery"
-          },
-          "batteryDischargeControl": {
-            "description": "Home battery discharge is prevented during fast charging and planned charging.",
+          "batteryBoost": {
+            "description": "Battery boost is active. When enabled, home battery power is used for fast charging.",
             "type": "boolean"
           },
-          "batteryGridChargeActive": {
-            "description": "Home battery is currently charged from grid.",
-            "type": "boolean"
+          "chargeCurrents": {
+            "description": "Charging current per phase in A.",
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
           },
-          "batteryGridChargeLimit": {
-            "description": "Price or emission limit for charging the home battery from grid.",
-            "nullable": true,
+          "chargeDuration": {
+            "description": "Duration of the current charging session in seconds.",
             "type": "number"
           },
-          "batteryMode": {
-            "$ref": "#/components/schemas/BatteryMode"
-          },
-          "bufferSoc": {
-            "description": "Battery buffer SoC in %. Energy above this level may be used for charging in solar mode.",
+          "chargePower": {
+            "description": "Current charging power in W.",
             "type": "number"
           },
-          "bufferStartSoc": {
-            "description": "Battery buffer start SoC in %. Solar charging starts automatically above this level.",
+          "chargeRemainingDuration": {
+            "description": "Estimated remaining charging time in seconds.",
             "type": "number"
           },
-          "circuits": {
-            "additionalProperties": {
-              "$ref": "#/components/schemas/Circuit"
-            },
-            "description": "Load management circuits, keyed by circuit name.",
-            "type": "object"
+          "chargeRemainingEnergy": {
+            "description": "Estimated remaining energy in kWh.",
+            "type": "number"
           },
-          "config": {
-            "description": "Path of the evcc configuration file.",
-            "type": "string"
+          "chargeTotalImport": {
+            "description": "Total energy imported by the charge meter in kWh.",
+            "type": "number"
           },
-          "consumers": {
-            "description": "Consumption meters of individual devices for monitoring purposes.",
+          "chargeVoltages": {
+            "description": "Charging voltage per phase in V.",
+            "type": "array",
             "items": {
-              "$ref": "#/components/schemas/Meter"
-            },
-            "type": "array"
-          },
-          "currency": {
-            "$ref": "#/components/schemas/Currency"
+              "type": "number"
+            }
           },
-          "database": {
-            "description": "Path of the evcc database.",
-            "type": "string"
+          "chargedEnergy": {
+            "description": "Energy charged in the current charging session in kWh.",
+            "type": "number"
           },
-          "demoMode": {
-            "description": "Instance runs in demo mode.",
+          "chargerFeatureAutodetectDisabled": {
+            "description": "The connected vehicle is not identified automatically by its status.",
             "type": "boolean"
           },
-          "deviceColors": {
-            "description": "Colors assigned to devices for consistent UI display.",
-            "items": {
-              "$ref": "#/components/schemas/DeviceColorEntry"
-            },
-            "type": "array"
-          },
-          "eebus": {
-            "$ref": "#/components/schemas/Eebus"
-          },
-          "experimental": {
-            "description": "Experimental UI features are enabled.",
+          "chargerFeatureAverage": {
+            "description": "Values are averaged.",
             "type": "boolean"
           },
-          "ext": {
-            "description": "Additional meters for monitoring purposes.",
-            "items": {
-              "$ref": "#/components/schemas/Meter"
-            },
-            "type": "array"
-          },
-          "fatal": {
-            "description": "Fatal startup errors.",
-            "items": {
-              "$ref": "#/components/schemas/FatalError"
-            },
-            "type": "array"
-          },
-          "forecast": {
-            "$ref": "#/components/schemas/Forecast"
-          },
-          "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"
-          },
-          "grid": {
-            "$ref": "#/components/schemas/Meter"
-          },
-          "gridConfigured": {
-            "description": "A grid meter is configured.",
+          "chargerFeatureCacheable": {
+            "description": "Values are cached.",
             "type": "boolean"
           },
-          "hems": {
-            "$ref": "#/components/schemas/Hems"
-          },
-          "historyUpdated": {
-            "description": "Time of the last energy history update.",
-            "format": "date-time",
-            "type": "string"
-          },
-          "homePower": {
-            "description": "Home consumption power in W.",
-            "type": "number"
-          },
-          "influx": {
-            "$ref": "#/components/schemas/InfluxConfig"
-          },
-          "interval": {
-            "description": "Update interval of the control loop in seconds.",
-            "type": "number"
-          },
-          "loadpoints": {
-            "description": "Charging locations. One entry per configured loadpoint.",
-            "items": {
-              "$ref": "#/components/schemas/Loadpoint"
-            },
-            "type": "array"
-          },
-          "mcp": {
-            "description": "Built-in MCP server is enabled.",
+          "chargerFeatureClimaterDisabled": {
+            "description": "The climater state of the connected vehicle is ignored for charge control.",
             "type": "boolean"
           },
-          "messaging": {
-            "$ref": "#/components/schemas/GenericConfigStatus"
-          },
-          "messagingEvents": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/MessagingEvents"
-              }
-            ],
-            "description": "Configured notification messages per event type.",
-            "nullable": true
-          },
-          "modbusproxy": {
-            "description": "Modbus proxy configuration.",
-            "items": {
-              "$ref": "#/components/schemas/ModbusProxy"
-            },
-            "nullable": true,
-            "type": "array"
-          },
-          "mqtt": {
-            "$ref": "#/components/schemas/MqttConfig"
-          },
-          "network": {
-            "$ref": "#/components/schemas/Network"
-          },
-          "ocpp": {
-            "$ref": "#/components/schemas/Ocpp"
-          },
-          "ocppforwarder": {
-            "$ref": "#/components/schemas/OcppForwarder"
-          },
-          "optimizer": {
-            "description": "Battery optimizer is enabled.",
+          "chargerFeatureCoarseCurrent": {
+            "description": "Charger only supports full ampere steps for current control.",
             "type": "boolean"
           },
-          "optimizerChargingStrategies": {
-            "description": "Available battery optimizer charging strategies.",
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
+          "chargerFeatureContinuous": {
+            "description": "Charger is a heating device where disabled means normal operation.",
+            "type": "boolean"
           },
-          "optimizerChargingStrategy": {
-            "description": "Selected battery optimizer charging strategy.",
-            "type": "string"
+          "chargerFeatureHeating": {
+            "description": "Charger is a heating device. SoC values represent temperature in degrees.",
+            "type": "boolean"
           },
-          "prioritySoc": {
-            "description": "Battery priority SoC in %. Home battery is charged first while below this level.",
-            "type": "number"
+          "chargerFeatureIntegratedDevice": {
+            "description": "Charger is an always-connected device without vehicles and charging sessions, like a heat pump.",
+            "type": "boolean"
           },
-          "pv": {
-            "description": "Solar generation meters. One entry per configured pv meter.",
-            "items": {
-              "$ref": "#/components/schemas/Meter"
-            },
-            "type": "array"
+          "chargerFeatureOffline": {
+            "description": "The connected vehicle only provides data while charging.",
+            "type": "boolean"
           },
-          "pvEnergy": {
-            "description": "Total solar generation energy in kWh.",
-            "type": "number"
+          "chargerFeatureRetryable": {
+            "description": "Vehicle API calls are retried on failure.",
+            "type": "boolean"
           },
-          "pvPower": {
-            "description": "Total solar generation power in W. Sum of all pv meters.",
-            "type": "number"
+          "chargerFeatureStreaming": {
+            "description": "The connected vehicle pushes data updates instead of being polled.",
+            "type": "boolean"
           },
-          "remote": {
-            "$ref": "#/components/schemas/Remote"
+          "chargerFeatureSwitchDevice": {
+            "description": "Charger is a switchable device without current control, like a heat pump or switch socket.",
+            "type": "boolean"
           },
-          "residualPower": {
-            "description": "Configured grid operating point in W. Positive values maintain grid import.",
-            "type": "number"
+          "chargerFeatureWakeUpDisabled": {
+            "description": "No wake-up calls are sent to the connected vehicle.",
+            "type": "boolean"
           },
-          "setupRequired": {
-            "description": "Initial setup is required.",
+          "chargerFeatureWelcomeCharge": {
+            "description": "The connected vehicle may need a short welcome charge to start communicating.",
             "type": "boolean"
           },
-          "shm": {
-            "$ref": "#/components/schemas/ShmConfig"
+          "chargerIcon": {
+            "description": "Charger icon name for UI display.",
+            "type": "string",
+            "nullable": true
           },
-          "siteTitle": {
-            "description": "Configured site title.",
-            "type": "string"
+          "chargerPhases1p3p": {
+            "description": "Charger supports automatic switching between 1-phase and 3-phase charging.",
+            "type": "boolean"
           },
-          "smartCostAvailable": {
-            "description": "A dynamic grid price or CO₂ forecast is configured.",
+          "chargerSinglePhase": {
+            "description": "Charger is physically connected with a single phase.",
             "type": "boolean"
           },
-          "smartCostType": {
-            "$ref": "#/components/schemas/SmartCostType"
+          "chargerStatusReason": {
+            "description": "Reason why the charger is waiting, like a pending authorization or a required disconnect.",
+            "nullable": true,
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ChargerStatusReason"
+              }
+            ]
           },
-          "smartFeedInPriorityAvailable": {
-            "description": "A feed-in tariff with forecast is configured.",
+          "charging": {
+            "description": "A vehicle is connected and charging.",
             "type": "boolean"
           },
-          "sponsor": {
-            "$ref": "#/components/schemas/Sponsor"
-          },
-          "startupCompleted": {
-            "description": "Startup has completed.",
+          "connected": {
+            "description": "A vehicle is connected to the charger.",
             "type": "boolean"
           },
-          "statistics": {
-            "$ref": "#/components/schemas/Statistics"
+          "connectedDuration": {
+            "description": "Duration since the vehicle was connected, in seconds.",
+            "type": "number"
           },
-          "system": {
-            "description": "Operating system and architecture.",
-            "example": "linux/amd64",
-            "type": "string"
+          "disableDelay": {
+            "description": "Delay before charging stops in solar mode, in seconds.",
+            "type": "number"
           },
-          "tariffCo2": {
-            "description": "Current grid CO₂ emissions in g/kWh.",
+          "disableThreshold": {
+            "description": "Grid draw power above which charging stops in solar mode, in W.",
             "type": "number"
           },
-          "tariffCo2Home": {
-            "description": "Current CO₂ emissions of home consumption in g/kWh, taking the green energy share into account.",
+          "effectiveLimitSoc": {
+            "description": "Currently applied SoC limit in %.",
             "type": "number"
           },
-          "tariffCo2Loadpoints": {
-            "description": "Current CO₂ emissions of charging in g/kWh, taking the green energy share into account.",
+          "effectiveMaxCurrent": {
+            "description": "Currently applied maximum charging current in A.",
             "type": "number"
           },
-          "tariffFeedIn": {
-            "description": "Current feed-in rate per kWh in the configured currency.",
+          "effectiveMinCurrent": {
+            "description": "Currently applied minimum charging current in A.",
             "type": "number"
           },
-          "tariffGrid": {
-            "description": "Current grid energy price per kWh in the configured currency.",
+          "effectivePlanId": {
+            "description": "Id of the currently applied charging plan. Zero if no plan is active.",
             "type": "number"
           },
-          "tariffPriceHome": {
-            "description": "Current energy price of home consumption per kWh, taking the green energy share into account.",
+          "effectivePlanSoc": {
+            "description": "SoC goal in % of the currently applied charging plan.",
             "type": "number"
           },
-          "tariffPriceLoadpoints": {
-            "description": "Current energy price of charging per kWh, taking the green energy share into account.",
+          "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"
           },
-          "tariffSolar": {
-            "description": "Current cost of solar generation per kWh in the configured currency.",
+          "enableDelay": {
+            "description": "Delay before charging starts in solar mode, in seconds.",
             "type": "number"
           },
-          "tariffs": {
-            "$ref": "#/components/schemas/GenericConfigStatus"
+          "enableThreshold": {
+            "description": "Available surplus power above which charging starts in solar mode, in W.",
+            "type": "number"
           },
-          "telemetry": {
-            "description": "Telemetry is enabled.",
+          "enabled": {
+            "description": "Charger is currently allowed to charge.",
             "type": "boolean"
           },
-          "timezone": {
-            "description": "Server time zone abbreviation and UTC offset.",
-            "example": "CEST +02:00",
-            "type": "string"
-          },
-          "vehicles": {
-            "additionalProperties": {
-              "$ref": "#/components/schemas/Vehicle"
-            },
-            "description": "Configured vehicles, keyed by vehicle name.",
-            "type": "object"
-          },
-          "version": {
-            "description": "Running evcc version.",
-            "type": "string"
-          }
-        },
-        "required": [
-          "loadpoints",
-          "forecast",
-          "vehicles"
-        ],
-        "type": "object"
-      },
-      "StaticEnergyPlan": {
-        "description": "Charging plan with an energy goal.",
-        "properties": {
-          "energy": {
-            "description": "Energy goal in kWh.",
+          "limitEnergy": {
+            "description": "Session energy limit in kWh. Zero means no limit.",
             "type": "number"
           },
-          "time": {
-            "description": "Target time.",
-            "format": "date-time",
-            "type": "string"
-          }
-        },
-        "required": [
-          "energy",
-          "time"
-        ],
-        "type": "object"
-      },
-      "StaticPlan": {
-        "anyOf": [
-          {
-            "$ref": "#/components/schemas/StaticSocPlan"
+          "limitSoc": {
+            "description": "Session SoC limit in %. Zero means no limit.",
+            "type": "number"
           },
-          {
-            "$ref": "#/components/schemas/StaticEnergyPlan"
-          }
-        ],
-        "description": "Charging plan with a fixed target time and a SoC or energy goal."
-      },
-      "StaticSocPlan": {
-        "description": "Charging plan with a SoC goal.",
-        "properties": {
-          "soc": {
-            "description": "SoC goal in %.",
+          "maxCurrent": {
+            "description": "Maximum charging current in A.",
             "type": "number"
           },
-          "time": {
-            "description": "Target time.",
-            "format": "date-time",
-            "type": "string"
-          }
-        },
-        "required": [
-          "soc",
-          "time"
-        ],
-        "type": "object"
-      },
-      "Statistics": {
-        "description": "Charging statistics, keyed by time period.",
-        "properties": {
-          "30d": {
-            "$ref": "#/components/schemas/StatisticsData"
+          "minCurrent": {
+            "description": "Minimum charging current in A.",
+            "type": "number"
           },
-          "365d": {
-            "$ref": "#/components/schemas/StatisticsData"
+          "minSocNotReached": {
+            "description": "Vehicle SoC is below the configured minimum SoC.",
+            "type": "boolean"
           },
-          "thisYear": {
-            "$ref": "#/components/schemas/StatisticsData"
+          "mode": {
+            "$ref": "#/components/schemas/ChargeMode",
+            "description": "Charging behavior."
           },
-          "total": {
-            "$ref": "#/components/schemas/StatisticsData"
-          }
-        },
-        "required": [
-          "30d",
-          "365d",
-          "thisYear",
-          "total"
-        ],
-        "type": "object"
-      },
-      "StatisticsData": {
-        "description": "Aggregated charging statistics for a time period.",
-        "properties": {
-          "avgCo2": {
-            "description": "Average CO₂ emissions in g/kWh.",
+          "offeredCurrent": {
+            "description": "Current offered to the vehicle in A.",
             "type": "number"
           },
-          "avgPrice": {
-            "description": "Average energy price per kWh in the configured currency.",
-            "type": "number"
+          "phaseAction": {
+            "$ref": "#/components/schemas/PhaseAction",
+            "description": "Pending phase switching action in solar mode."
           },
-          "chargedKWh": {
-            "description": "Total charged energy in kWh.",
+          "phaseRemaining": {
+            "description": "Remaining time until the pending phase switching action executes, in seconds.",
             "type": "number"
           },
-          "solarPercentage": {
-            "description": "Share of solar energy in %.",
+          "phasesActive": {
+            "description": "Number of phases expected to be used for charging.",
             "type": "number"
-          }
-        },
-        "required": [
-          "avgCo2",
-          "avgPrice",
-          "chargedKWh",
-          "solarPercentage"
-        ],
-        "type": "object"
-      },
-      "TimeseriesEntry": {
-        "description": "A forecast value at a point in time.",
-        "properties": {
-          "ts": {
-            "description": "Time of the forecast value.",
-            "format": "date-time",
-            "type": "string"
           },
-          "val": {
-            "description": "Forecast power in W.",
-            "type": "number"
-          }
-        },
-        "required": [
-          "val",
-          "ts"
-        ],
-        "type": "object"
-      },
-      "Timestamp": {
-        "description": "Timestamp in RFC3339 format",
-        "format": "date-time",
-        "type": "string"
-      },
-      "Vehicle": {
-        "description": "A configured vehicle.",
-        "properties": {
-          "capacity": {
-            "description": "Usable battery capacity in kWh.",
+          "phasesConfigured": {
+            "description": "Configured phase mode. 0 is automatic switching, 1 and 3 select a fixed phase count.",
             "type": "number"
           },
-          "features": {
-            "description": "Feature flags of the vehicle implementation.",
+          "plan": {
+            "description": "Time slots of the current charging plan.",
+            "type": "array",
+            "nullable": true,
             "items": {
-              "type": "string"
-            },
-            "type": "array"
+              "$ref": "#/components/schemas/Rate"
+            }
           },
-          "icon": {
-            "description": "Vehicle icon name for UI display.",
-            "type": "string"
+          "planActive": {
+            "description": "The current time slot is an active charging slot of the plan.",
+            "type": "boolean"
           },
-          "limitSoc": {
-            "description": "SoC limit in %. Charging stops when reached.",
+          "planEnergy": {
+            "description": "Energy goal of the charging plan in kWh.",
             "type": "number"
           },
-          "minSoc": {
-            "description": "Minimum SoC in %. Vehicle is fast-charged until this level is reached.",
+          "planOverrun": {
+            "description": "Duration in seconds the charging plan is projected to miss its target time.",
             "type": "number"
           },
-          "name": {
-            "description": "Unique vehicle name used in API routes and configuration.",
-            "type": "string"
+          "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."
           },
-          "plan": {
-            "$ref": "#/components/schemas/StaticPlan"
+          "pvRemaining": {
+            "description": "Remaining time until the pending charge start or stop action executes, in seconds.",
+            "type": "number"
           },
-          "planStrategy": {
-            "$ref": "#/components/schemas/PlanStrategy"
+          "sessionCo2PerKWh": {
+            "description": "Average CO₂ emissions of the current charging session in g/kWh.",
+            "type": "number",
+            "nullable": true
           },
-          "repeatingPlans": {
-            "description": "Repeating charging plans.",
-            "items": {
-              "$ref": "#/components/schemas/RepeatingPlan"
-            },
-            "nullable": true,
-            "type": "array"
+          "sessionEnergy": {
+            "description": "Energy charged in the current charging session in kWh.",
+            "type": "number"
           },
-          "title": {
-            "description": "Vehicle title for UI display.",
-            "type": "string"
-          }
-        },
-        "required": [
-          "repeatingPlans",
-          "planStrategy",
-          "title"
-        ],
-        "type": "object"
-      },
-      "VehicleName": {
-        "example": "vehicle_1",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/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/docs/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"
-      }
-    }
-  },
-  "info": {
-    "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"
+          "sessionPrice": {
+            "description": "Total cost of the current charging session in the configured currency.",
+            "type": "number",
+            "nullable": true
           },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
+          "sessionPricePerKWh": {
+            "description": "Average energy price of the current charging session per kWh in the configured currency.",
+            "type": "number",
+            "nullable": true
           },
-          {
-            "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"
-              }
-            }
+          "sessionSolarPercentage": {
+            "description": "Share of solar energy in the current charging session in %.",
+            "type": "number"
           },
-          "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"
+          "smartCostActive": {
+            "description": "Fast charging with cheap or clean grid energy is currently active.",
+            "type": "boolean"
           },
-          "401": {
-            "description": "Invalid admin password"
+          "smartCostLimit": {
+            "description": "Price or emission limit for fast charging with grid energy.",
+            "type": "number",
+            "nullable": true
           },
-          "403": {
-            "description": "Forbidden in demo mode"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
+          "smartCostNextStart": {
+            "description": "Start of the next fast charging period with cheap or clean grid energy.",
+            "type": "string",
+            "nullable": true,
+            "format": "date-time"
           },
-          {
-            "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"
-              }
-            }
+          "smartFeedInPriorityActive": {
+            "description": "Charging pause for prioritized feed-in is currently active.",
+            "type": "boolean"
           },
-          "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"
-                }
-              }
-            }
+          "smartFeedInPriorityLimit": {
+            "description": "Feed-in rate limit above which charging is paused.",
+            "type": "number",
+            "nullable": true
           },
-          "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"
-              }
-            }
+          "smartFeedInPriorityNextStart": {
+            "description": "Start of the next charging pause for prioritized feed-in.",
+            "type": "string",
+            "nullable": true,
+            "format": "date-time"
           },
-          "required": true
-        },
-        "responses": {
-          "202": {
-            "description": "Success"
+          "title": {
+            "description": "Loadpoint title for UI display.",
+            "type": "string"
           },
-          "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/docs/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/docs/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/docs/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"
+          "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."
           }
         },
-        "summary": "Set external battery mode",
-        "tags": [
-          "battery"
+        "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",
+          "effectivePlanId",
+          "effectivePlanSoc",
+          "effectivePlanTime",
+          "effectivePlanStrategy",
+          "effectivePriority",
+          "enableDelay",
+          "enableThreshold",
+          "enabled",
+          "limitEnergy",
+          "limitSoc",
+          "maxCurrent",
+          "minCurrent",
+          "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"
         ]
-      }
-    },
-    "/buffersoc/{soc}": {
-      "post": {
-        "description": "Set battery buffer SoC.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/battery"
-        },
-        "operationId": "setBufferSoc",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+      },
+      "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"
           }
         },
-        "summary": "Set battery buffer SoC",
-        "tags": [
-          "battery"
+        "required": [
+          "start",
+          "end",
+          "value"
         ]
-      }
-    },
-    "/bufferstartsoc/{soc}": {
-      "post": {
-        "description": "Set battery buffer start SoC.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/battery"
-        },
-        "operationId": "setBufferStartSoc",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+      },
+      "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"
           }
         },
-        "summary": "Set battery buffer start SoC",
-        "tags": [
-          "battery"
+        "required": [
+          "energy",
+          "complete"
         ]
-      }
-    },
-    "/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"
+      },
+      "TimeseriesEntry": {
+        "description": "A forecast value at a point in time.",
+        "type": "object",
+        "properties": {
+          "val": {
+            "description": "Forecast power in W.",
+            "type": "number"
           },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
+          "ts": {
+            "description": "Time of the forecast value.",
+            "type": "string",
+            "format": "date-time"
           }
         },
-        "security": [
-          {
-            "cookieAuth": []
-          },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "Download database backup",
-        "tags": [
-          "db"
+        "required": [
+          "val",
+          "ts"
         ]
-      }
-    },
-    "/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"
-              }
-            }
+      },
+      "SolarDetails": {
+        "description": "Solar production forecast.",
+        "type": "object",
+        "properties": {
+          "scale": {
+            "description": "Correction factor applied to the forecast based on past production.",
+            "type": "number"
           },
-          "required": true
-        },
-        "responses": {
-          "204": {
-            "description": "Reset successful, instance is restarting"
+          "today": {
+            "$ref": "#/components/schemas/EnergyByDay",
+            "description": "Expected production today."
           },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
+          "tomorrow": {
+            "$ref": "#/components/schemas/EnergyByDay",
+            "description": "Expected production tomorrow."
           },
-          {
-            "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"
+          "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"
+            }
           }
-        ],
-        "requestBody": {
-          "content": {
-            "multipart/form-data": {
-              "schema": {
-                "properties": {
-                  "file": {
-                    "description": "SQLite database backup file",
-                    "format": "binary",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "file"
-                ],
-                "type": "object"
-              }
+        }
+      },
+      "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"
             }
           },
-          "required": true
-        },
-        "responses": {
-          "204": {
-            "description": "Restore successful, instance is restarting"
-          },
-          "400": {
-            "description": "Invalid file or missing fields"
+          "co2": {
+            "description": "CO₂ emission forecast in g/kWh per time slot.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
+            }
           },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
+          "solar": {
+            "$ref": "#/components/schemas/SolarDetails",
+            "description": "Solar production forecast."
           },
-          {
-            "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"
+          "planner": {
+            "description": "Charging cost forecast used by the plan optimizer per time slot.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
             }
           },
-          {
-            "description": "Language (defaults to accept header)",
-            "in": "query",
-            "name": "lang",
-            "schema": {
-              "example": "de",
-              "type": "string"
+          "feedin": {
+            "description": "Feed-in rate forecast. Rate per kWh in the configured currency per time slot.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ForecastSlot"
             }
           }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "$ref": "#/components/schemas/GridSessions"
-                    }
-                  },
-                  "type": "object"
-                }
-              },
-              "text/csv": {
-                "schema": {
-                  "description": "Download csv-file",
-                  "format": "binary",
-                  "type": "string"
-                }
-              }
-            },
-            "description": "Success"
+        }
+      },
+      "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"
           }
         },
-        "summary": "Grid limitation sessions",
-        "tags": [
-          "sessions"
+        "required": [
+          "error"
         ]
-      }
-    },
-    "/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",
+      },
+      "AuthProviders": {
+        "description": "Status of configured vehicle authentication providers, keyed by provider name.",
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "id": {
               "type": "string"
+            },
+            "authenticated": {
+              "type": "boolean"
             }
           },
-          {
-            "description": "End time (RFC3339)",
-            "in": "query",
-            "name": "to",
-            "schema": {
-              "example": "2026-07-02T00:00:00Z",
-              "format": "date-time",
-              "type": "string"
-            }
+          "required": [
+            "id",
+            "authenticated"
+          ]
+        }
+      },
+      "BatteryMeter": {
+        "description": "Measurement data of a single home battery meter.",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Unique device name of the meter.",
+            "type": "string"
           },
-          {
-            "description": "Aggregation interval. Examples: 15m, 1h, day, month",
-            "in": "query",
-            "name": "aggregate",
-            "schema": {
-              "default": "15m",
-              "example": "1h",
-              "type": "string"
-            }
+          "power": {
+            "description": "Current power in W.",
+            "type": "number"
           },
-          {
-            "description": "Group results by loadpoint",
-            "in": "query",
-            "name": "grouped",
-            "schema": {
-              "default": false,
-              "example": false,
-              "type": "boolean"
-            }
+          "title": {
+            "description": "Meter title for UI display.",
+            "type": "string"
           },
-          {
-            "description": "Filter by entity group",
-            "in": "query",
-            "name": "group",
-            "schema": {
-              "enum": [
-                "forecast",
-                "battery",
-                "grid",
-                "pv",
-                "home",
-                "loadpoint",
-                "meter",
-                "consumer"
-              ],
-              "example": "battery",
-              "type": "string"
-            }
+          "icon": {
+            "description": "Meter icon name for UI display.",
+            "type": "string"
           },
-          {
-            "description": "Filter by entity name",
-            "in": "query",
-            "name": "name",
-            "schema": {
-              "example": "db:8",
-              "type": "string"
-            }
+          "energy": {
+            "description": "Total energy in kWh.",
+            "type": "number"
           },
-          {
-            "description": "Filter by entity title",
-            "in": "query",
-            "name": "title",
-            "schema": {
-              "example": "Battery",
-              "type": "string"
-            }
+          "returnEnergy": {
+            "description": "Total exported energy in kWh.",
+            "type": "number"
           },
-          {
-            "description": "Response format",
-            "in": "query",
-            "name": "format",
-            "schema": {
-              "default": "json",
-              "enum": [
-                "json",
-                "csv"
-              ],
-              "example": "json",
-              "type": "string"
+          "powers": {
+            "description": "Power per phase in W.",
+            "type": "array",
+            "items": {
+              "type": "number"
             }
           },
-          {
-            "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"
+          "currents": {
+            "description": "Current per phase in A.",
+            "type": "array",
+            "items": {
+              "type": "number"
             }
-          }
-        ],
-        "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/docs/features/battery#battery-boost"
-        },
-        "operationId": "setLoadpointBatteryBoost",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+          "soc": {
+            "description": "Charge level in %.",
+            "type": "number"
           },
-          {
-            "$ref": "#/components/parameters/enable"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/BooleanResult"
+          "controllable": {
+            "description": "Battery supports external control of its operation mode.",
+            "type": "boolean"
+          },
+          "capacity": {
+            "description": "Battery capacity in kWh.",
+            "type": "number"
           }
         },
-        "summary": "Set battery boost",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "capacity",
+          "controllable",
+          "power",
+          "soc"
         ]
-      }
-    },
-    "/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/docs/features/battery#battery-boost"
-        },
-        "operationId": "setLoadpointBatteryBoostLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "BatteryForecastPoint": {
+        "description": "A projected home battery charge level at a point in time.",
+        "type": "object",
+        "properties": {
+          "soc": {
+            "description": "Projected charge level in %.",
+            "type": "number"
           },
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/IntegerResult"
+          "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"
           }
         },
-        "summary": "Set battery boost SoC limit",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "soc",
+          "time"
         ]
-      }
-    },
-    "/loadpoints/{id}/disable/delay/{delay}": {
-      "post": {
-        "description": "Delay before charging stops in solar mode.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/reference/configuration/loadpoints"
-        },
-        "operationId": "setLoadpointDisableDelay",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "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."
           },
-          {
-            "$ref": "#/components/parameters/delay"
+          "lowest": {
+            "$ref": "#/components/schemas/BatteryForecastPoint",
+            "description": "Projected lowest charge level."
           }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NanoSecondsResult"
+        }
+      },
+      "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."
           }
         },
-        "summary": "Disable threshold-delay",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "power",
+          "capacity",
+          "soc"
         ]
-      }
-    },
-    "/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/docs/reference/configuration/loadpoints#threshold-1"
-        },
-        "operationId": "setLoadpointDisableThreshold",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "Meter": {
+        "description": "Measurement data of a single meter.",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Unique device name of the meter.",
+            "type": "string"
           },
-          {
-            "$ref": "#/components/parameters/threshold"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+          "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"
+            }
           }
         },
-        "summary": "Disable threshold",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "power"
         ]
-      }
-    },
-    "/loadpoints/{id}/enable/delay/{delay}": {
-      "post": {
-        "description": "Delay before charging starts in solar mode.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/reference/configuration/loadpoints#delay"
-        },
-        "operationId": "setLoadpointEnableDelay",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "GenericConfigStatus": {
+        "description": "Configuration and runtime status of an integration. Structure depends on configuration.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "description": "Static configuration."
           },
-          {
-            "$ref": "#/components/parameters/delay"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NanoSecondsResult"
+          "status": {
+            "description": "Runtime status."
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "type": "string",
+            "enum": [
+              "file",
+              "db"
+            ]
           }
-        },
-        "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/docs/reference/configuration/loadpoints#threshold"
-        },
-        "operationId": "setLoadpointEnableThreshold",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+        }
+      },
+      "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"
           },
-          {
-            "$ref": "#/components/parameters/threshold"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+          "clientKey": {
+            "description": "Client key for TLS connections.",
+            "type": "string"
           }
         },
-        "summary": "Enable threshold",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "broker",
+          "topic"
         ]
-      }
-    },
-    "/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/docs/features/limit"
-        },
-        "operationId": "setLoadpointEnergyLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "InfluxConfig": {
+        "description": "InfluxDB integration configuration.",
+        "type": "object",
+        "properties": {
+          "url": {
+            "description": "InfluxDB server URL.",
+            "type": "string"
           },
-          {
-            "$ref": "#/components/parameters/energy"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+          "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"
           }
         },
-        "summary": "Update energy limit",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "url",
+          "database",
+          "org"
         ]
-      }
-    },
-    "/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/docs/features/limit"
-        },
-        "operationId": "setLoadpointSocLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "Network": {
+        "description": "Network configuration.",
+        "type": "object",
+        "properties": {
+          "schema": {
+            "description": "URL schema, http or https.",
+            "type": "string"
           },
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+          "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"
           }
         },
-        "summary": "Update session SoC limit",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "host",
+          "port"
         ]
-      }
-    },
-    "/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"
+      },
+      "HemsConfig": {
+        "description": "Home energy management system configuration.",
+        "type": "object",
+        "properties": {
+          "configured": {
+            "description": "A home energy management system is configured.",
+            "type": "boolean"
           }
         },
-        "summary": "Update maximum current",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "configured"
         ]
-      }
-    },
-    "/loadpoints/{id}/mincurrent/{current}": {
-      "post": {
-        "description": "Updates the minimum current of the loadpoint.",
-        "operationId": "setLoadpointMinCurrent",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "HemsStatus": {
+        "description": "Current external limits imposed by the home energy management system.",
+        "type": "object",
+        "properties": {
+          "dimmed": {
+            "description": "Consumption is currently limited.",
+            "type": "boolean"
           },
-          {
-            "$ref": "#/components/parameters/current"
+          "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"
           }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+        }
+      },
+      "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"
           }
         },
-        "summary": "Update minimum current",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "vendorId",
+          "deviceId"
         ]
-      }
-    },
-    "/loadpoints/{id}/mode/{mode}": {
-      "post": {
-        "description": "Changes the charging behavior of the loadpoint.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/solar-charging"
-        },
-        "operationId": "setLoadpointMode",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "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."
           },
-          {
-            "$ref": "#/components/parameters/mode"
+          "status": {
+            "$ref": "#/components/schemas/SponsorStatus",
+            "description": "Runtime status."
+          },
+          "yamlSource": {
+            "description": "Source of the configuration, evcc.yaml file or database.",
+            "type": "string",
+            "enum": [
+              "file",
+              "db"
+            ]
           }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "$ref": "#/components/schemas/ChargeMode"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
+        }
+      },
+      "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"
           }
         },
-        "summary": "Update charge mode",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "public",
+          "private"
         ]
-      }
-    },
-    "/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/docs/reference/configuration/loadpoints#phases"
-        },
-        "operationId": "setLoadpointPhases",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "EebusConfig": {
+        "description": "EEBus integration configuration.",
+        "type": "object",
+        "properties": {
+          "uri": {
+            "description": "URI the EEBus service listens on.",
+            "type": "string"
           },
-          {
-            "$ref": "#/components/parameters/phases"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+          "port": {
+            "description": "Port the EEBus service listens on.",
+            "type": "number"
           },
-          "400": {
-            "description": "Invalid phases-value. You have most likely entered the value 0 for a wallbox that cannot switch phases automatically."
+          "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."
           }
         },
-        "summary": "Update allowed phases",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "port",
+          "shipid"
         ]
-      }
-    },
-    "/loadpoints/{id}/plan": {
-      "get": {
-        "description": "Returns the current charging plan for this loadpoint.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/plans"
-        },
-        "operationId": "getLoadpointPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "allOf": [
-                        {
-                          "properties": {
-                            "planId": {
-                              "$ref": "#/components/schemas/Id"
-                            }
-                          },
-                          "type": "object"
-                        },
-                        {
-                          "$ref": "#/components/schemas/PlanRates"
-                        }
-                      ]
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
+      },
+      "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"
           }
         },
-        "summary": "Get charging plan",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "ski"
         ]
-      }
-    },
-    "/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/docs/features/plans"
-        },
-        "operationId": "deleteLoadpointEnergyPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "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"
+            ]
           }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/EmptyResult"
+        }
+      },
+      "RemoteConfig": {
+        "description": "Remote access configuration.",
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "description": "Remote access is enabled.",
+            "type": "boolean"
           }
         },
-        "summary": "Delete energy-based charging plan",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "enabled"
         ]
-      }
-    },
-    "/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/docs/features/plans"
-        },
-        "operationId": "setLoadpointEnergyPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "RemoteStatus": {
+        "description": "Remote access connection status.",
+        "type": "object",
+        "properties": {
+          "connected": {
+            "description": "Connection to the remote access server is established.",
+            "type": "boolean"
           },
-          {
-            "$ref": "#/components/parameters/energy"
+          "url": {
+            "description": "Remote access URL.",
+            "type": "string"
           },
-          {
-            "$ref": "#/components/parameters/timestamp"
+          "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"
+            }
           }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "$ref": "#/components/schemas/StaticEnergyPlan"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
+        },
+        "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"
+            ]
           }
-        },
-        "summary": "Set energy-based charging plan",
-        "tags": [
-          "loadpoints"
+        }
+      },
+      "ModbusProxyReadonly": {
+        "description": "How the Modbus proxy handles write requests.",
+        "type": "string",
+        "enum": [
+          "false",
+          "true",
+          "deny"
         ]
-      }
-    },
-    "/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/docs/features/plans"
-        },
-        "operationId": "previewLoadpointRepeatingPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "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"
           },
-          {
-            "$ref": "#/components/parameters/soc"
+          "rtu": {
+            "description": "Use RTU protocol over TCP.",
+            "type": "boolean"
           },
-          {
-            "$ref": "#/components/parameters/weekdays"
+          "device": {
+            "description": "Serial device path.",
+            "type": "string"
           },
-          {
-            "$ref": "#/components/parameters/hourMinuteTime"
+          "baudrate": {
+            "$ref": "#/components/schemas/ModbusBaudrate",
+            "description": "Serial baud rate."
           },
-          {
-            "$ref": "#/components/parameters/timezone"
+          "comset": {
+            "$ref": "#/components/schemas/ModbusComset",
+            "description": "Serial communication parameters."
           }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/PlanRatesResult"
+        }
+      },
+      "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."
           }
         },
-        "summary": "Repeating plan preview",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "port",
+          "readonly",
+          "settings"
         ]
-      }
-    },
-    "/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/docs/features/plans"
-        },
-        "operationId": "previewLoadpointEnergyPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "MessagingEvent": {
+        "description": "A configured notification message.",
+        "type": "object",
+        "properties": {
+          "title": {
+            "description": "Message title template.",
+            "type": "string"
           },
-          {
-            "$ref": "#/components/parameters/energy"
+          "msg": {
+            "description": "Message body template.",
+            "type": "string"
           },
-          {
-            "$ref": "#/components/parameters/timestamp"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/PlanRatesResult"
+          "disabled": {
+            "description": "Notifications for this event are disabled.",
+            "type": "boolean"
           }
         },
-        "summary": "Simulate energy-based charging plan",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "title",
+          "msg",
+          "disabled"
         ]
-      }
-    },
-    "/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/docs/features/plans"
-        },
-        "operationId": "previewLoadpointSocPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "MessagingEvents": {
+        "description": "Configured notification messages, keyed by event type.",
+        "type": "object",
+        "properties": {
+          "start": {
+            "$ref": "#/components/schemas/MessagingEvent"
           },
-          {
-            "$ref": "#/components/parameters/soc"
+          "stop": {
+            "$ref": "#/components/schemas/MessagingEvent"
           },
-          {
-            "$ref": "#/components/parameters/timestamp"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/PlanRatesResult"
+          "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"
           }
         },
-        "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/docs/features/plans"
-        },
-        "operationId": "setLoadpointPlanStrategy",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
+        "required": [
+          "start",
+          "stop",
+          "connect",
+          "disconnect",
+          "soc",
+          "guest",
+          "asleep",
+          "planoverrun"
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/PlanStrategy"
-              }
-            }
+        "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"
           },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "$ref": "#/components/schemas/PlanStrategy"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
+          "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"
           }
         },
-        "summary": "Set plan strategy",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "power"
         ]
-      }
-    },
-    "/loadpoints/{id}/priority/{priority}": {
-      "post": {
-        "description": "Set loadpoint priority.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/reference/configuration/loadpoints#priority"
-        },
-        "operationId": "setLoadpointPriority",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "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"
           },
-          {
-            "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"
+          "color": {
+            "type": "string"
           }
         },
-        "summary": "Set priority",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "title",
+          "color"
         ]
-      }
-    },
-    "/loadpoints/{id}/smartcostlimit": {
-      "delete": {
-        "description": "Delete cost or emission limit for fast-charging with grid energy.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/dynamic-prices"
-        },
-        "operationId": "deleteLoadpointSmartCostLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
+      },
+      "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"
           }
         },
-        "summary": "Delete smart charging cost limit",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "soc",
+          "time"
         ]
-      }
-    },
-    "/loadpoints/{id}/smartcostlimit/{cost}": {
-      "post": {
-        "description": "Set cost or emission limit for fast-charging with grid energy.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/dynamic-prices"
-        },
-        "operationId": "setLoadpointSmartCostLimit",
-        "parameters": [
+      },
+      "StaticPlan": {
+        "description": "Charging plan with a fixed target time and a SoC or energy goal.",
+        "anyOf": [
           {
-            "$ref": "#/components/parameters/id"
+            "$ref": "#/components/schemas/StaticSocPlan"
           },
           {
-            "$ref": "#/components/parameters/costLimit"
+            "$ref": "#/components/schemas/StaticEnergyPlan"
           }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+        ]
+      },
+      "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"
           }
         },
-        "summary": "Set smart charging cost limit",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "weekdays",
+          "time",
+          "tz",
+          "soc",
+          "active"
         ]
-      }
-    },
-    "/loadpoints/{id}/smartfeedinprioritylimit": {
-      "delete": {
-        "description": "Delete limit for feed-in priority optimization.",
-        "operationId": "deleteLoadpointSmartFeedInPriorityLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "Vehicle": {
+        "description": "A configured vehicle.",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Unique vehicle name used in API routes and configuration.",
+            "type": "string"
+          },
+          "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"
           }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
+        },
+        "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"
           }
         },
-        "summary": "Delete smart feed-in priority limit",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "avgCo2",
+          "avgPrice",
+          "chargedKWh",
+          "solarPercentage"
         ]
-      }
-    },
-    "/loadpoints/{id}/smartfeedinprioritylimit/{cost}": {
-      "post": {
-        "description": "Set limit for feed-in priority optimization.",
-        "operationId": "setLoadpointSmartFeedInPriorityLimit",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "Statistics": {
+        "description": "Charging statistics, keyed by time period.",
+        "type": "object",
+        "properties": {
+          "30d": {
+            "$ref": "#/components/schemas/StatisticsData"
           },
-          {
-            "$ref": "#/components/parameters/costLimit"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+          "365d": {
+            "$ref": "#/components/schemas/StatisticsData"
+          },
+          "thisYear": {
+            "$ref": "#/components/schemas/StatisticsData"
+          },
+          "total": {
+            "$ref": "#/components/schemas/StatisticsData"
           }
         },
-        "summary": "Set smart feed-in priority limit",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "30d",
+          "365d",
+          "thisYear",
+          "total"
         ]
-      }
-    },
-    "/loadpoints/{id}/vehicle": {
-      "delete": {
-        "description": "Remove vehicle from loadpoint. Connected vehicle is treated as guest vehicle.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/vehicle"
-        },
-        "operationId": "removeLoadpointVehicle",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/EmptyResult"
+      },
+      "OcppConfig": {
+        "description": "OCPP server configuration.",
+        "type": "object",
+        "properties": {
+          "port": {
+            "description": "Port the OCPP server listens on.",
+            "type": "number"
           }
         },
-        "summary": "Remove vehicle",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "port"
         ]
       },
-      "patch": {
-        "description": "Starts the automatic vehicle detection process.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/vehicle"
-        },
-        "operationId": "startLoadpointVehicleDetection",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/EmptyResult"
+      "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."
           }
         },
-        "summary": "Start vehicle detection",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "id",
+          "status"
         ]
-      }
-    },
-    "/loadpoints/{id}/vehicle/{name}": {
-      "post": {
-        "description": "Assigns vehicle to loadpoint.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/vehicle"
-        },
-        "operationId": "assignLoadpointVehicle",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/id"
+      },
+      "OcppStatus": {
+        "description": "OCPP server status.",
+        "type": "object",
+        "properties": {
+          "externalUrl": {
+            "description": "Externally reachable URL of the OCPP server.",
+            "type": "string"
           },
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "properties": {
-                        "vehicle": {
-                          "$ref": "#/components/schemas/VehicleTitle"
-                        }
-                      },
-                      "type": "object"
-                    }
-                  },
-                  "type": "object"
-                }
-              }
-            },
-            "description": "Success"
+          "stations": {
+            "description": "Connection status per configured station.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/OcppStationStatus"
+            }
           }
         },
-        "summary": "Assign vehicle",
-        "tags": [
-          "loadpoints"
+        "required": [
+          "stations"
         ]
-      }
-    },
-    "/prioritysoc/{soc}": {
-      "post": {
-        "description": "Set battery priority SoC.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/battery"
-        },
-        "operationId": "setPrioritySoc",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/soc"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+      },
+      "Ocpp": {
+        "description": "OCPP server configuration and status.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/OcppConfig"
+          },
+          "status": {
+            "$ref": "#/components/schemas/OcppStatus"
           }
         },
-        "summary": "Set battery priority SoC",
-        "tags": [
-          "battery"
+        "required": [
+          "config",
+          "status"
         ]
-      }
-    },
-    "/residualpower/{power}": {
-      "post": {
-        "description": "Set grid connection operating point.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/reference/configuration/site#residualpower"
-        },
-        "operationId": "setResidualPower",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/power"
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NumberResult"
+      },
+      "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"
           }
         },
-        "summary": "Set grid residual power",
-        "tags": [
-          "battery"
+        "required": [
+          "stationId",
+          "upstreamUrl"
         ]
-      }
-    },
-    "/session/{id}": {
-      "delete": {
-        "description": "Delete charging session.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/sessions"
-        },
-        "operationId": "deleteSession",
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/NullResult"
+      },
+      "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"
           }
         },
-        "summary": "Delete charging session",
-        "tags": [
-          "sessions"
+        "required": [
+          "chargerId",
+          "upstreamUrl",
+          "upstreamConnected"
         ]
       },
-      "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/docs/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"
-              }
+      "OcppForwarder": {
+        "description": "OCPP forwarder rules and upstream connection status.",
+        "type": "object",
+        "properties": {
+          "config": {
+            "description": "Static configuration.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/OcppForwarderRule"
             }
           },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "description": "Success"
+          "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"
+            ]
           }
-        },
-        "summary": "Update charging session",
-        "tags": [
-          "sessions"
-        ]
-      }
-    },
-    "/sessions": {
-      "get": {
-        "description": "Returns a list of charging sessions.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/sessions"
-        },
-        "operationId": "getSessions",
-        "parameters": [
-          {
-            "description": "Response format (default json)",
-            "in": "query",
-            "name": "format",
-            "schema": {
-              "enum": [
-                "csv"
-              ],
-              "type": "string"
+        }
+      },
+      "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"
+          },
+          "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"
             }
           },
-          {
-            "description": "Language (defaults to accept header)",
-            "in": "query",
-            "name": "lang",
-            "schema": {
-              "example": "de",
-              "type": "string"
-            }
+          "messaging": {
+            "$ref": "#/components/schemas/GenericConfigStatus",
+            "description": "Messaging services configuration. Structure depends on configuration."
           },
-          {
-            "description": "Month filter",
-            "in": "query",
-            "name": "month",
-            "schema": {
-              "example": 2,
-              "maximum": 12,
-              "minimum": 1,
-              "type": "integer"
-            }
+          "messagingEvents": {
+            "description": "Configured notification messages per event type.",
+            "nullable": true,
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/MessagingEvents"
+              }
+            ]
           },
-          {
-            "description": "Year filter",
-            "in": "query",
-            "name": "year",
-            "schema": {
-              "example": 2025,
-              "type": "integer"
+          "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"
             }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "$ref": "#/components/schemas/ChargingSessions"
-                    }
-                  },
-                  "type": "object"
-                }
-              },
-              "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/docs/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"
-        ]
-      }
-    },
-    "/state": {
-      "get": {
-        "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.",
-        "operationId": "state",
-        "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"
+          "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"
+          },
+          "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"
             }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/State"
-                }
-              }
-            },
-            "description": "Success"
-          }
-        },
-        "summary": "System state",
-        "tags": [
-          "state"
-        ]
-      }
-    },
-    "/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": []
+          "statistics": {
+            "$ref": "#/components/schemas/Statistics",
+            "description": "Charging statistics over different time periods."
           },
-          {
-            "bearerAuth": []
-          }
-        ],
-        "summary": "Clear cache",
-        "tags": [
-          "system"
-        ]
-      }
-    },
-    "/system/log": {
-      "get": {
-        "description": "Returns the latest log lines.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/reference/configuration/log"
-        },
-        "operationId": "getSystemLogs",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/logAreas"
+          "authDisabled": {
+            "description": "Authentication is disabled.",
+            "type": "boolean"
           },
-          {
-            "$ref": "#/components/parameters/logLevel"
+          "config": {
+            "description": "Path of the evcc configuration file.",
+            "type": "string"
           },
-          {
-            "description": "Number of log lines to return",
-            "example": 100,
-            "in": "query",
-            "name": "count",
-            "schema": {
-              "type": "integer"
-            }
+          "database": {
+            "description": "Path of the evcc database.",
+            "type": "string"
           },
-          {
-            "description": "File type",
-            "in": "query",
-            "name": "format",
-            "schema": {
-              "enum": [
-                "txt"
-              ],
+          "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"
             }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    }
-                  },
-                  "type": "object"
-                }
-              },
-              "text/plain": {
-                "schema": {
-                  "description": "Download txt-file",
-                  "format": "binary",
-                  "type": "string"
-                }
-              }
-            },
-            "description": "Success"
           },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "cookieAuth": []
+          "mcp": {
+            "description": "Built-in MCP server is enabled.",
+            "type": "boolean"
           },
-          {
-            "bearerAuth": []
+          "demoMode": {
+            "description": "Instance runs in demo mode.",
+            "type": "boolean"
           }
-        ],
-        "summary": "Logs",
-        "tags": [
-          "system"
+        },
+        "required": [
+          "loadpoints",
+          "forecast",
+          "vehicles"
         ]
       }
     },
-    "/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": {
-                  "properties": {
-                    "result": {
-                      "$ref": "#/components/schemas/LogAreas"
-                    }
-                  },
-                  "type": "object"
+    "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"
+        }
+      },
+      "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"
                 }
               }
-            },
-            "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/docs/devices/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": {
-                    "result": {
-                      "properties": {
-                        "rates": {
-                          "$ref": "#/components/schemas/Rates"
-                        }
-                      },
-                      "type": "object"
-                    }
-                  },
-                  "type": "object"
+        }
+      },
+      "NumberResult": {
+        "description": "Success - Number result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "number"
                 }
               }
-            },
-            "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/docs/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/docs/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}/plan/repeating": {
-      "post": {
-        "description": "Updates the repeating charging plan.",
-        "externalDocs": {
-          "url": "https://docs.evcc.io/en/docs/features/plans"
-        },
-        "operationId": "updateVehicleRepeatingPlans",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
+            }
           }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "items": {
-                  "$ref": "#/components/schemas/RepeatingPlan"
-                },
-                "type": "array"
+        }
+      },
+      "IntegerResult": {
+        "description": "Success - Integer result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "integer"
+                }
               }
             }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
+          }
+        }
+      },
+      "SocResult": {
+        "description": "Success - Soc result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "object",
                   "properties": {
-                    "result": {
-                      "items": {
-                        "$ref": "#/components/schemas/RepeatingPlan"
-                      },
-                      "type": "array"
+                    "soc": {
+                      "$ref": "#/components/schemas/Soc"
                     }
-                  },
-                  "type": "object"
+                  }
                 }
               }
-            },
-            "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/docs/features/plans"
-        },
-        "operationId": "deleteVehicleSocPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
+            }
           }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/EmptyResult"
+        }
+      },
+      "PlanRatesResult": {
+        "description": "Success - PlanRates result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "$ref": "#/components/schemas/PlanRates"
+                }
+              }
+            }
           }
-        },
-        "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/docs/features/plans"
-        },
-        "operationId": "setVehicleSocPlan",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
-          },
-          {
-            "$ref": "#/components/parameters/soc"
-          },
-          {
-            "$ref": "#/components/parameters/timestamp"
+        }
+      },
+      "BooleanResult": {
+        "description": "Success - Boolean result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "boolean"
+                }
+              }
+            }
           }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "properties": {
-                        "soc": {
-                          "$ref": "#/components/schemas/Soc"
-                        },
-                        "time": {
-                          "$ref": "#/components/schemas/Timestamp"
-                        }
-                      },
-                      "type": "object"
-                    }
-                  },
+        }
+      },
+      "NullResult": {
+        "description": "Success - Null result",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "description": "Value is always null",
+                  "nullable": true,
                   "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/docs/features/plans"
-        },
-        "operationId": "setVehiclePlanStrategy",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/vehicleName"
+            }
           }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/PlanStrategy"
+        }
+      },
+      "BlankResponse": {
+        "description": "Success - Blank response"
+      },
+      "SuccessResult": {
+        "description": "Success",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "type": "string",
+                  "example": "OK"
+                }
               }
             }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "result": {
-                      "$ref": "#/components/schemas/PlanStrategy"
-                    }
-                  },
-                  "type": "object"
+          }
+        }
+      },
+      "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
                 }
               }
-            },
-            "description": "Success"
+            }
           }
-        },
-        "summary": "Set plan strategy",
-        "tags": [
-          "vehicles"
-        ]
+        }
       }
-    }
-  },
-  "tags": [
-    {
-      "name": "state"
-    },
-    {
-      "name": "auth"
-    },
-    {
-      "name": "battery"
-    },
-    {
-      "name": "db"
-    },
-    {
-      "name": "experimental"
-    },
-    {
-      "name": "general"
-    },
-    {
-      "name": "loadpoints"
-    },
-    {
-      "name": "sessions"
-    },
-    {
-      "name": "system"
     },
-    {
-      "name": "tariffs"
-    },
-    {
-      "name": "vehicles"
+    "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"
+      }
     }
-  ]
-}
\ No newline at end of file
+  }
+}
diff --git a/server/mcp/openapi.md b/server/mcp/openapi.md
index ed447cfe060..78bfd3c23e3 100644
--- a/server/mcp/openapi.md
+++ b/server/mcp/openapi.md
@@ -1086,7 +1086,7 @@ 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.
+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
 
diff --git a/server/openapi.go b/server/openapi.go
index b4a40393871..972ae548c61 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 00000000000..b513507b955
--- /dev/null
+++ b/server/openapi.state.yaml
@@ -0,0 +1,1730 @@
+# 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
+        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
+        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.
+          type: number
+      required:
+        - capacity
+        - controllable
+        - power
+        - soc
+    BatteryMode:
+      description: Battery operation mode.
+      type: string
+      enum:
+        - unknown
+        - normal
+        - hold
+        - charge
+        - holdcharge
+    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"
+    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
+        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
+        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
+        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
+        title:
+          description: Loadpoint title for UI display.
+          type: string
+        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
+        - effectivePlanId
+        - effectivePlanSoc
+        - effectivePlanTime
+        - effectivePlanStrategy
+        - effectivePriority
+        - enableDelay
+        - enableThreshold
+        - enabled
+        - limitEnergy
+        - limitSoc
+        - maxCurrent
+        - minCurrent
+        - 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
+    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"
+      required:
+        - start
+        - stop
+        - connect
+        - disconnect
+        - soc
+        - guest
+        - asleep
+        - planoverrun
+      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
+        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 3dbf4e71be3..d7c6eaa2b5c 100644
--- a/server/openapi.yaml
+++ b/server/openapi.yaml
@@ -424,7 +424,7 @@ paths:
                 type: object
                 properties:
                   result:
-                    $ref: "#/components/schemas/ChargeMode"
+                    $ref: "./openapi.state.yaml#/components/schemas/ChargeMode"
   /loadpoints/{id}/phases/{phases}:
     post:
       operationId: setLoadpointPhases
@@ -504,7 +504,7 @@ paths:
                 type: object
                 properties:
                   result:
-                    $ref: "#/components/schemas/StaticEnergyPlan"
+                    $ref: "./openapi.state.yaml#/components/schemas/StaticEnergyPlan"
   /loadpoints/{id}/plan/repeating/preview/{soc}/{weekdays}/{hourMinuteTime}/{timezone}:
     get:
       operationId: previewLoadpointRepeatingPlan
@@ -571,7 +571,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/PlanStrategy"
+              $ref: "./openapi.state.yaml#/components/schemas/PlanStrategy"
       responses:
         200:
           description: Success
@@ -581,7 +581,7 @@ paths:
                 type: object
                 properties:
                   result:
-                    $ref: "#/components/schemas/PlanStrategy"
+                    $ref: "./openapi.state.yaml#/components/schemas/PlanStrategy"
   /loadpoints/{id}/priority/{priority}:
     post:
       operationId: setLoadpointPriority
@@ -928,7 +928,7 @@ paths:
     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."
+      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."
       tags:
         - state
       parameters:
@@ -950,7 +950,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/State"
+                $ref: "./openapi.state.yaml#/components/schemas/State"
   /system/log:
     get:
       operationId: getSystemLogs
@@ -1135,7 +1135,7 @@ paths:
             schema:
               type: array
               items:
-                $ref: "#/components/schemas/RepeatingPlan"
+                $ref: "./openapi.state.yaml#/components/schemas/RepeatingPlan"
       responses:
         "200":
           description: Success
@@ -1147,7 +1147,7 @@ paths:
                   result:
                     type: array
                     items:
-                      $ref: "#/components/schemas/RepeatingPlan"
+                      $ref: "./openapi.state.yaml#/components/schemas/RepeatingPlan"
   /vehicles/{name}/plan/soc:
     delete:
       operationId: deleteVehicleSocPlan
@@ -1206,7 +1206,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/PlanStrategy"
+              $ref: "./openapi.state.yaml#/components/schemas/PlanStrategy"
       responses:
         200:
           description: Success
@@ -1216,7 +1216,7 @@ paths:
                 type: object
                 properties:
                   result:
-                    $ref: "#/components/schemas/PlanStrategy"
+                    $ref: "./openapi.state.yaml#/components/schemas/PlanStrategy"
   /db/backup:
     get:
       operationId: downloadBackup
@@ -1572,1742 +1572,13 @@ components:
     Rates:
       type: array
       items:
-        $ref: "#/components/schemas/Rate"
+        $ref: "./openapi.state.yaml#/components/schemas/Rate"
     Soc:
       description: SOC in %
       type: number
       example: 60
       minimum: 0
       maximum: 100
-    # GENERATED_STATE_SCHEMAS_BEGIN (source: assets/js/types/evcc.ts, update: npm run openapi)
-    State:
-      description: Complete system state as returned by /api/state and pushed via websocket and MQTT. The overall structure is stable, details may change 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
-        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
-        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.
-          type: number
-      required:
-        - capacity
-        - controllable
-        - power
-        - soc
-    BatteryMode:
-      description: Battery operation mode.
-      type: string
-      enum:
-        - unknown
-        - normal
-        - hold
-        - charge
-        - holdcharge
-    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"
-    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
-        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
-        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
-        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
-        title:
-          description: Loadpoint title for UI display.
-          type: string
-        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
-        - effectivePlanId
-        - effectivePlanSoc
-        - effectivePlanTime
-        - effectivePlanStrategy
-        - effectivePriority
-        - enableDelay
-        - enableThreshold
-        - enabled
-        - limitEnergy
-        - limitSoc
-        - maxCurrent
-        - minCurrent
-        - 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
-    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"
-      required:
-        - start
-        - stop
-        - connect
-        - disconnect
-        - soc
-        - guest
-        - asleep
-        - planoverrun
-      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
-        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
-    # GENERATED_STATE_SCHEMAS_END
     Timestamp:
       description: Timestamp in RFC3339 format
       type: string
@@ -3404,7 +1675,7 @@ components:
       in: path
       required: true
       schema:
-        $ref: "#/components/schemas/ChargeMode"
+        $ref: "./openapi.state.yaml#/components/schemas/ChargeMode"
     soc:
       name: soc
       description: SOC in %
@@ -3459,7 +1730,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
diff --git a/server/openapi_test.go b/server/openapi_test.go
index bd1b6e38e9f..b10bae04faf 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))

From 0f2294aadaa8e407768d3bd5c646e20da6e6bfbf Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Mon, 13 Jul 2026 15:22:46 +0200
Subject: [PATCH 6/8] OpenAPI: fix ChargeMode ref and const keyword after
 master merge

---
 scripts/state-schema/schemas.ts | 5 +++++
 server/mcp/openapi.json         | 6 ++++--
 server/openapi.state.yaml       | 3 ++-
 server/openapi.yaml             | 2 +-
 4 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/scripts/state-schema/schemas.ts b/scripts/state-schema/schemas.ts
index c2aac248e11..9cc1358a154 100644
--- a/scripts/state-schema/schemas.ts
+++ b/scripts/state-schema/schemas.ts
@@ -113,6 +113,11 @@ function normalizeNullables(schema: AnySchema): void {
         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];
diff --git a/server/mcp/openapi.json b/server/mcp/openapi.json
index e5cbdea37ae..6eefd8d4ac1 100644
--- a/server/mcp/openapi.json
+++ b/server/mcp/openapi.json
@@ -1921,7 +1921,7 @@
                   "type": "object",
                   "properties": {
                     "mode": {
-                      "$ref": "#/components/schemas/Mode"
+                      "$ref": "#/components/schemas/ChargeMode"
                     }
                   }
                 }
@@ -4441,7 +4441,9 @@
               },
               {
                 "type": "string",
-                "const": ""
+                "enum": [
+                  ""
+                ]
               }
             ]
           },
diff --git a/server/openapi.state.yaml b/server/openapi.state.yaml
index b1cc5d79da1..9e7c61d3134 100644
--- a/server/openapi.state.yaml
+++ b/server/openapi.state.yaml
@@ -1757,7 +1757,8 @@ components:
           anyOf:
             - $ref: "#/components/schemas/ChargeMode"
             - type: string
-              const: ""
+              enum:
+                - ""
         minSoc:
           description: Minimum SoC in %. Vehicle is fast-charged until this level is reached.
           type: number
diff --git a/server/openapi.yaml b/server/openapi.yaml
index 4dd4dda8e10..70eb9ecc759 100644
--- a/server/openapi.yaml
+++ b/server/openapi.yaml
@@ -1167,7 +1167,7 @@ paths:
                 type: object
                 properties:
                   mode:
-                    $ref: "#/components/schemas/Mode"
+                    $ref: "./openapi.state.yaml#/components/schemas/ChargeMode"
   /vehicles/{name}/plan/repeating:
     post:
       operationId: updateVehicleRepeatingPlans

From 80130465f4e5b553155c622a8e0604ad6a481246 Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Mon, 13 Jul 2026 15:31:51 +0200
Subject: [PATCH 7/8] State API: validate date-time formats via ajv-formats

---
 package-lock.json                | 1 +
 package.json                     | 1 +
 scripts/state-schema/validate.ts | 2 ++
 3 files changed, 4 insertions(+)

diff --git a/package-lock.json b/package-lock.json
index c6b3ed84fe9..20c5dc31372 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -58,6 +58,7 @@
         "@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",
diff --git a/package.json b/package.json
index 1190c236e7f..2663c9838aa 100644
--- a/package.json
+++ b/package.json
@@ -78,6 +78,7 @@
     "@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",
diff --git a/scripts/state-schema/validate.ts b/scripts/state-schema/validate.ts
index e61beca68b1..1d568d9299c 100644
--- a/scripts/state-schema/validate.ts
+++ b/scripts/state-schema/validate.ts
@@ -1,6 +1,7 @@
 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";
 
@@ -72,6 +73,7 @@ export function validateState(payload: any): { errors: string[]; undocumented: s
   expandNullable(schemas);
 
   const ajv = new Ajv2020({ strict: false, allErrors: true });
+  addFormats(ajv);
   const validateFn = ajv.compile({
     $ref: "#/components/schemas/State",
     components: { schemas },

From 658580fdf5f763a1224a3b2e7b27fa4e7b077b88 Mon Sep 17 00:00:00 2001
From: andig <cpuidle@gmail.com>
Date: Sun, 19 Jul 2026 11:58:58 +0200
Subject: [PATCH 8/8] State API test: widen poll timeout for loadpoint warm-up

heat pump loadpoints publish session/plan/effective fields only after the
first control cycles. the default 5s expect.poll timeout raced this cold
start, failing on ci where each retry restarts evcc.
---
 tests/state-api.spec.ts | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/tests/state-api.spec.ts b/tests/state-api.spec.ts
index 2b8f699ac72..527d1f975fb 100644
--- a/tests/state-api.spec.ts
+++ b/tests/state-api.spec.ts
@@ -16,10 +16,13 @@ test.afterAll(async () => {
 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];
-    })
+    .poll(
+      async () => {
+        const res = await request.get("/api/state");
+        const { errors, undocumented } = validateState(await res.json());
+        return [...errors, ...undocumented];
+      },
+      { timeout: 30000 }
+    )
     .toEqual([]);
 });