evcc (self-hosted)

evcc (self-hosted) Loadpoints API

The loadpoints API from evcc (self-hosted) — 29 operation(s) for loadpoints.

GitHub OpenAPI
Business capability
Home Energy AE-200.30

Operations 30

POST /loadpoints/{id}/alwayscharge/{alwaysCharge} Set always charge #
POST /loadpoints/{id}/batteryboost/{enable} Set battery boost #
POST /loadpoints/{id}/batteryboostlimit/{soc} Set battery boost SoC limit #
POST /loadpoints/{id}/disable/delay/{delay} Disable threshold-delay #
POST /loadpoints/{id}/disable/threshold/{threshold} Disable threshold #
POST /loadpoints/{id}/enable/delay/{delay} Enable threshold-delay #
POST /loadpoints/{id}/enable/threshold/{threshold} Enable threshold #
POST /loadpoints/{id}/limitenergy/{energy} Update energy limit #
POST /loadpoints/{id}/limitsoc/{soc} Update session SoC limit #
POST /loadpoints/{id}/maxcurrent/{current} Update maximum current #
POST /loadpoints/{id}/mincurrent/{current} Update minimum current #
POST /loadpoints/{id}/mintemp/{temp} Update minimum temperature #
POST /loadpoints/{id}/mode/{mode} Update charge mode #
POST /loadpoints/{id}/phases/{phases} Update allowed phases #
GET /loadpoints/{id}/plan Get charging plan #
DELETE /loadpoints/{id}/plan/energy Delete energy-based charging plan #
POST /loadpoints/{id}/plan/energy/{energy}/{timestamp} Set energy-based charging plan #
GET /loadpoints/{id}/plan/repeating/preview/{soc}/{weekdays}/{hourMinuteTime}/{timezone} Repeating plan preview #
GET /loadpoints/{id}/plan/static/preview/soc/{soc}/{timestamp} Simulate SoC-based charging plan #
GET /loadpoints/{id}/plan/static/preview/energy/{energy}/{timestamp} Simulate energy-based charging plan #
POST /loadpoints/{id}/plan/strategy Set plan strategy #
POST /loadpoints/{id}/priority/{priority} Set priority #
DELETE /loadpoints/{id}/smartcostlimit Delete smart charging cost limit #
POST /loadpoints/{id}/smartcostlimit/{cost} Set smart charging cost limit #
DELETE /loadpoints/{id}/smartfeedinprioritylimit Delete smart feed-in priority limit #
POST /loadpoints/{id}/smartfeedinprioritylimit/{cost} Set smart feed-in priority limit #
POST /loadpoints/{id}/solarshare/{share} Set solar share #
DELETE /loadpoints/{id}/vehicle Remove vehicle #
PATCH /loadpoints/{id}/vehicle Start vehicle detection #
POST /loadpoints/{id}/vehicle/{name} Assign vehicle #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/evcc/openapi/evcc-loadpoints-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/evcc/json-schema/evcc-state-schema.json
📊
JSONSchema
https://artifacts.apis.io/evcc/json-schema/evcc-grid-sessions-schema.json
📊
JSONSchema
https://artifacts.apis.io/evcc/json-schema/evcc-charging-sessions-schema.json
📊
JSONSchema
https://artifacts.apis.io/evcc/json-schema/evcc-repeating-plan-schema.json
📊
JSONSchema
https://artifacts.apis.io/evcc/json-schema/evcc-flow-schema.json
📊
JSONSchema
https://artifacts.apis.io/evcc/json-schema/evcc-onboarding-state-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/evcc:evcc-loadpoints-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

evcc-loadpoints-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: evcc Loadpoints API
  description: smart charging. open source energy management.
  version: 0.2.0
  contact:
    url: https://github.com/evcc-io/evcc
servers:
- url: https://demo.evcc.io/api
tags:
- name: loadpoints
paths:
  /loadpoints/{id}/alwayscharge/{alwaysCharge}:
    post:
      operationId: setLoadpointAlwaysCharge
      summary: Set always charge
      description: Updates the always charge state. When active, smart mode charges continuously at least at minimum power. The once state resets when the vehicle is disconnected.
      externalDocs:
        url: https://docs.evcc.io/en/features/solar-charging
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/alwaysCharge'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlwaysCharge'
        '400':
          description: Not supported for chargers without current control.
  /loadpoints/{id}/batteryboost/{enable}:
    post:
      operationId: setLoadpointBatteryBoost
      summary: Set battery boost
      description: 'Enable or disable battery boost. When active, the maximum available home battery power is added until the home battery is drained to configured SoC limit. Note: boost will not work while the battery is on hold (e.g. during fast charging or planned charging with discharge prevention enabled).'
      externalDocs:
        url: https://docs.evcc.io/en/features/battery#battery-boost
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/enable'
      responses:
        '200':
          $ref: '#/components/responses/BooleanResult'
  /loadpoints/{id}/batteryboostlimit/{soc}:
    post:
      operationId: setLoadpointBatteryBoostLimit
      summary: Set battery boost SoC limit
      description: Set the SoC limit for battery boost. Home battery will be used to support charging up to this SoC level. A value of 100 (default) disabled the boost feature in UI and API.
      externalDocs:
        url: https://docs.evcc.io/en/features/battery#battery-boost
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/soc'
      responses:
        '200':
          $ref: '#/components/responses/IntegerResult'
  /loadpoints/{id}/disable/delay/{delay}:
    post:
      operationId: setLoadpointDisableDelay
      summary: Disable threshold-delay
      description: Delay before charging stops in smart mode.
      externalDocs:
        url: https://docs.evcc.io/en/reference/configuration/loadpoints
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/delay'
      responses:
        '200':
          $ref: '#/components/responses/NanoSecondsResult'
  /loadpoints/{id}/disable/threshold/{threshold}:
    post:
      operationId: setLoadpointDisableThreshold
      summary: Disable threshold
      description: Specifies the grid draw power to stop charging in smart mode.
      externalDocs:
        url: https://docs.evcc.io/en/reference/configuration/loadpoints#threshold-1
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/threshold'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/enable/delay/{delay}:
    post:
      operationId: setLoadpointEnableDelay
      summary: Enable threshold-delay
      description: Delay before charging starts in smart mode.
      externalDocs:
        url: https://docs.evcc.io/en/reference/configuration/loadpoints#delay
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/delay'
      responses:
        '200':
          $ref: '#/components/responses/NanoSecondsResult'
  /loadpoints/{id}/enable/threshold/{threshold}:
    post:
      operationId: setLoadpointEnableThreshold
      summary: Enable threshold
      description: Specifies the available surplus power to start charging in smart mode.
      externalDocs:
        url: https://docs.evcc.io/en/reference/configuration/loadpoints#threshold
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/threshold'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/limitenergy/{energy}:
    post:
      operationId: setLoadpointEnergyLimit
      summary: Update energy limit
      description: Updates the energy limit of the loadpoint. Only available for guest vehicles and vehicles with unknown SoC. Limit is removed on vehicle disconnect.
      externalDocs:
        url: https://docs.evcc.io/en/features/limits
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/energy'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/limitsoc/{soc}:
    post:
      operationId: setLoadpointSocLimit
      summary: Update session SoC limit
      description: Sets the session SoC limit. Cleared on disconnect. Takes precedence over the vehicle's configured limit while set; once cleared (set to 0), the vehicle limit applies again.
      externalDocs:
        url: https://docs.evcc.io/en/features/limits
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/soc'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/maxcurrent/{current}:
    post:
      operationId: setLoadpointMaxCurrent
      summary: Update maximum current
      description: Updates the maximum current of the loadpoint.
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/current'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/mincurrent/{current}:
    post:
      operationId: setLoadpointMinCurrent
      summary: Update minimum current
      description: Updates the minimum current of the loadpoint.
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/current'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/mintemp/{temp}:
    post:
      operationId: setLoadpointMinTemp
      summary: Update minimum temperature
      description: Sets the minimum temperature for heating devices. The device is heated as fast as possible while below this value. Set to 0 to disable.
      externalDocs:
        url: https://docs.evcc.io/en/features/limits
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/temp'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/mode/{mode}:
    post:
      operationId: setLoadpointMode
      summary: Update charge mode
      description: Changes the charging behavior of the loadpoint.
      externalDocs:
        url: https://docs.evcc.io/en/features/solar-charging
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/mode'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChargeMode'
  /loadpoints/{id}/phases/{phases}:
    post:
      operationId: setLoadpointPhases
      summary: Update allowed phases
      description: Updates the allowed phases of the loadpoint. Selects the desired phase mode for chargers with automatic phase switching. For manual phase switching chargers (via cable or Lasttrennschalter) this value tells evcc the actual phases.
      externalDocs:
        url: https://docs.evcc.io/en/reference/configuration/loadpoints#phases
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/phases'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
        '400':
          description: Invalid phases-value. You have most likely entered the value 0 for a charger that cannot switch phases automatically.
  /loadpoints/{id}/plan:
    get:
      operationId: getLoadpointPlan
      summary: Get charging plan
      description: Returns the current charging plan for this loadpoint.
      externalDocs:
        url: https://docs.evcc.io/en/features/plans
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    planId:
                      $ref: '#/components/schemas/Id'
                - $ref: '#/components/schemas/PlanRates'
  /loadpoints/{id}/plan/energy:
    delete:
      operationId: deleteLoadpointEnergyPlan
      summary: Delete energy-based charging plan
      description: Delete charging plan. Only available when a vehicle without SoC is connected.
      externalDocs:
        url: https://docs.evcc.io/en/features/plans
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/EmptyResult'
  /loadpoints/{id}/plan/energy/{energy}/{timestamp}:
    post:
      operationId: setLoadpointEnergyPlan
      summary: Set energy-based charging plan
      description: Create charging plan with fixed time and energy target. Only available when a vehicle without SoC is connected.
      externalDocs:
        url: https://docs.evcc.io/en/features/plans
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/energy'
      - $ref: '#/components/parameters/timestamp'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticEnergyPlan'
  /loadpoints/{id}/plan/repeating/preview/{soc}/{weekdays}/{hourMinuteTime}/{timezone}:
    get:
      operationId: previewLoadpointRepeatingPlan
      summary: Repeating plan preview
      description: Simulate repeating charging plan and return the result. Does not alter the actual charging plan.
      externalDocs:
        url: https://docs.evcc.io/en/features/plans
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/soc'
      - $ref: '#/components/parameters/weekdays'
      - $ref: '#/components/parameters/hourMinuteTime'
      - $ref: '#/components/parameters/timezone'
      responses:
        '200':
          $ref: '#/components/responses/PlanRatesResult'
  /loadpoints/{id}/plan/static/preview/soc/{soc}/{timestamp}:
    get:
      operationId: previewLoadpointSocPlan
      summary: Simulate SoC-based charging plan
      description: Simulate charging plan based on SoC goal. Does not alter the actual charging plan.
      externalDocs:
        url: https://docs.evcc.io/en/features/plans
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/soc'
      - $ref: '#/components/parameters/timestamp'
      responses:
        '200':
          $ref: '#/components/responses/PlanRatesResult'
  /loadpoints/{id}/plan/static/preview/energy/{energy}/{timestamp}:
    get:
      operationId: previewLoadpointEnergyPlan
      summary: Simulate energy-based charging plan
      description: Simulate charging plan based on energy goal. Does not alter the actual charging plan.
      externalDocs:
        url: https://docs.evcc.io/en/features/plans
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/energy'
      - $ref: '#/components/parameters/timestamp'
      responses:
        '200':
          $ref: '#/components/responses/PlanRatesResult'
  /loadpoints/{id}/plan/strategy:
    post:
      operationId: setLoadpointPlanStrategy
      summary: Set plan strategy
      description: Updates the charging plan strategy for the loadpoint.
      externalDocs:
        url: https://docs.evcc.io/en/features/plans
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PlanStrategy'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlanStrategy'
  /loadpoints/{id}/priority/{priority}:
    post:
      operationId: setLoadpointPriority
      summary: Set priority
      description: Set loadpoint priority.
      externalDocs:
        url: https://docs.evcc.io/en/reference/configuration/loadpoints#priority
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - name: priority
        in: path
        description: Higher number means higher priority.
        required: true
        example: 2
        schema:
          type: integer
          minimum: 0
      responses:
        '200':
          $ref: '#/components/responses/IntegerResult'
  /loadpoints/{id}/smartcostlimit:
    delete:
      operationId: deleteLoadpointSmartCostLimit
      summary: Delete smart charging cost limit
      description: Delete cost or emission limit for fast-charging with grid energy.
      externalDocs:
        url: https://docs.evcc.io/en/features/dynamic-prices
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/NullResult'
  /loadpoints/{id}/smartcostlimit/{cost}:
    post:
      operationId: setLoadpointSmartCostLimit
      summary: Set smart charging cost limit
      description: Set cost or emission limit for fast-charging with grid energy.
      externalDocs:
        url: https://docs.evcc.io/en/features/dynamic-prices
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/costLimit'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/smartfeedinprioritylimit:
    delete:
      operationId: deleteLoadpointSmartFeedInPriorityLimit
      summary: Delete smart feed-in priority limit
      description: Delete limit for feed-in priority optimization.
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/NullResult'
  /loadpoints/{id}/smartfeedinprioritylimit/{cost}:
    post:
      operationId: setLoadpointSmartFeedInPriorityLimit
      summary: Set smart feed-in priority limit
      description: Set limit for feed-in priority optimization.
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/costLimit'
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/solarshare/{share}:
    post:
      operationId: setLoadpointSolarShare
      summary: Set solar share
      description: Set the share of the minimum charging power that must come from solar surplus in smart mode. 1 (default) requires full surplus, 0 starts charging as soon as there is no grid import. Ignored while enable/disable thresholds are configured. Usually 0 to 1; values outside that range are possible for special cases.
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - name: share
        in: path
        description: Solar share of the minimum charging power.
        required: true
        example: 0.5
        schema:
          type: number
      responses:
        '200':
          $ref: '#/components/responses/NumberResult'
  /loadpoints/{id}/vehicle:
    delete:
      operationId: removeLoadpointVehicle
      summary: Remove vehicle
      description: Remove vehicle from loadpoint. Connected vehicle is treated as guest vehicle.
      externalDocs:
        url: https://docs.evcc.io/en/features/vehicle
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/EmptyResult'
    patch:
      operationId: startLoadpointVehicleDetection
      summary: Start vehicle detection
      description: Starts the automatic vehicle detection process.
      externalDocs:
        url: https://docs.evcc.io/en/features/vehicle
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/EmptyResult'
  /loadpoints/{id}/vehicle/{name}:
    post:
      operationId: assignLoadpointVehicle
      summary: Assign vehicle
      description: Assigns vehicle to loadpoint.
      externalDocs:
        url: https://docs.evcc.io/en/features/vehicle
      tags:
      - loadpoints
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/vehicleName'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  vehicle:
                    $ref: '#/components/schemas/VehicleTitle'
components:
  parameters:
    timestamp:
      name: timestamp
      description: Timestamp in RFC3339 format
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Timestamp'
    weekdays:
      name: weekdays
      description: The Weekdays
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Weekdays'
    alwaysCharge:
      name: alwaysCharge
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/AlwaysCharge'
    energy:
      name: energy
      description: Energy in kWh
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Energy'
    mode:
      name: mode
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/ChargeModeInput'
    id:
      name: id
      description: Loadpoint index starting at 1
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Id'
    costLimit:
      name: cost
      description: Cost limit in configured currency (default EUR) or CO₂ limit in g/kWh
      example: 0.25
      in: path
      required: true
      schema:
        type: number
    soc:
      name: soc
      description: SoC in %
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Soc'
    threshold:
      name: threshold
      description: Power in W
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Power'
    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'
    delay:
      name: delay
      description: Duration in seconds.
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Delay'
    temp:
      name: temp
      description: Temperature in °C
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Temp'
    enable:
      name: enable
      description: Charging mode.
      in: path
      required: true
      schema:
        type: string
        enum:
        - 'true'
        - 'false'
        - '1'
        - '0'
    phases:
      name: phases
      description: 'Number of phases. (0: auto, 1: 1-phase, 3: 3-phase)'
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Phases'
    timezone:
      name: timezone
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/IANATimeZone'
    hourMinuteTime:
      name: hourMinuteTime
      description: Time in `HOURS:MINUTES` format
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/HourMinuteTime'
  schemas:
    Delay:
      description: Duration in seconds.
      type: integer
      example: 60
    AlwaysCharge:
      description: Always charge state. Smart mode charges continuously at least at minimum power.
      type: string
      enum:
      - 'off'
      - 'on'
      - once
    Timestamp:
      description: Timestamp in RFC3339 format
      type: string
      format: date-time
    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
    Soc:
      description: SoC in %
      type: number
      example: 60
      minimum: 0
      maximum: 100
    Energy:
      description: Energy in kWh
      type: number
      example: 25.5
      minimum: 0
    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
    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
    VehicleName:
      externalDocs:
        url: https://docs.evcc.io/en/reference/configuration/vehicles#name
      type: string
      minLength: 1
      pattern: '[a-zA-Z0-9_.:-]+'
      example: vehicle_1
    VehicleTitle:
      externalDocs:
        url: https://docs.evcc.io/en/reference/configuration/vehicles#title
      type: string
      example: blauer e-Golf
    Rates:
      type: array
      items:
        $ref: '#/components/schemas/Rate'
    Power:
      description: Power in W
      type: number
      minimum: 0
      example: 2500
    HourMinuteTime:
      description: Time in `HH:MM` format
      type: string
      pattern: '[0-1][0-9]:[0-5][0-9]'
      format: HH:MM
      example: '12:30'
    Phases:
      description: 'Number of phases. (0: auto, 1: 1-phase, 3: 3-phase)'
      type: string
      example: '3'
      enum:
      - '0'
      - '1'
      - '3'
    PlanRates:
      type: object
      properties:
        duration:
          description: Duration in s
          type: integer
          minimum: 0
        plan:
          $ref: '#/components/schemas/Rates'
        planTime:
          $ref: '#/components/schemas/Timestamp'
        power:
          $ref: '#/components/schemas/Power'
    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
    ChargeMode:
      description: Charging mode.
      type: string
      enum:
      - 'off'
      - smart
      - now
    IANATimeZone:
      description: Timezone in IANA format
      externalDocs:
        url: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
      type: string
      example: Europe/Berlin
    Id:
      description: Loadpoint index starting at 1.
      type: integer
      example: 1
      minimum: 1
    Temp:
      description: Temperature in °C
      type: number
      example: 50
      minimum: 0
    ChargeModeInput:
      description: 'Charging behavior. The values `pv` and `minpv` are deprecated aliases: `pv` maps to `smart`, `minpv` maps to `smart` with always charge enabled.'
      type: string
      enum:
      - 'off'
      - smart
      - now
      - pv
      - minpv
      example: smart
    Current:
      description: Electric current in A
      type: number
      example: 16
      minimum: 0
  responses:
    NanoSecondsResult:
      description: Success - Number result - Unit is **nanoseconds**
      content:
        application/json:
          schema:
            type: integer
    PlanRatesResult:
      description: Success - PlanRates result
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PlanRates'
    BooleanResult:
      description: Success - Boolean result
      content:
        application/json:
          schema:
            type: boolean
    IntegerResult:
      description: Success - Integer result
      content:
        application/json:
          schema:
            type: integer
    EmptyResult:
      description: Success - Empty result
      content:
        application/json:
          schema:
            type: object
    NullResult:
      description: Success - Null result
      content:
        application/json:
          schema:
            description: Value is always null
            nullable: true
            type: object
    NumberResult:
      description: Success - Number result
      content:
        application/json:
          schema:
            type: number
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: auth
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Long-lived API key (prefixed `evcc_`, managed via /auth/apikey).

        Grants access to /api/db/* without requiring the X-Admin-Password header.

        '