name: Battery Management
description: Capability for reading and updating Enphase IQ Battery settings — profile, backup
  reserve, Storm Guard, load control, grid status, and per-battery telemetry — via the v4
  Monitoring API.
provider: enphase-energy
api: enphase-enlighten-systems-api-v4
version: '1.0'
operations:
  - operationId: getSystemBatterySettings
    method: GET
    path: /api/v4/systems/{system_id}/battery_settings
    description: Read battery profile, backup reserve percentage, very-low SoC, and tariff config.
  - operationId: updateSystemBatterySettings
    method: PUT
    path: /api/v4/systems/{system_id}/battery_settings
    description: Update battery profile, reserve percentage, or tariff. PUT-style replacement.
  - operationId: getSystemStormGuard
    method: GET
    path: /api/v4/systems/{system_id}/storm_guard
    description: Read Storm Guard status (enabled, self-test state).
  - operationId: updateSystemStormGuard
    method: PUT
    path: /api/v4/systems/{system_id}/storm_guard
    description: Enable or disable Storm Guard for a system.
  - operationId: getSystemGridStatus
    method: GET
    path: /api/v4/systems/{system_id}/grid_status
    description: Read current grid connection status (on-grid, off-grid, transitioning).
  - operationId: getSystemLoadControl
    method: GET
    path: /api/v4/systems/{system_id}/load_control
    description: Read load-control circuit configuration.
  - operationId: updateSystemLoadControl
    method: PUT
    path: /api/v4/systems/{system_id}/load_control
    description: Update load-control circuit configuration.
  - operationId: getBatteryLifetime
    method: GET
    path: /api/v4/systems/{system_id}/battery_lifetime
    description: Daily lifetime battery charge/discharge time series.
  - operationId: getBatteryTelemetry
    method: GET
    path: /api/v4/systems/{system_id}/telemetry/battery
    description: 15-minute battery telemetry — SoC, charge power/energy, discharge power/energy.
  - operationId: getEnchargeTelemetry
    method: GET
    path: /api/v4/systems/{system_id}/devices/encharges/{serial_no}/telemetry
    description: Per-Encharge battery telemetry.
inputs:
  - name: system_id
    type: integer
    required: true
auth:
  type: oauth2
  authorizationUrl: https://api.enphaseenergy.com/oauth/authorize
  tokenUrl: https://api.enphaseenergy.com/oauth/token
  scopes: [read, write]