Batteries

Battery system specifications for solar + storage optimization. Used to calculate optimal battery sizing and energy storage capacity. See Self-Sufficiency — Battery Impact and Dynamic vs Fixed — Battery Arbitrage.

GET/v1/batteries/cost-tiers

Get default battery installation cost tiers

Returns the tiered pricing schedule used for battery storage installations when no custom costPerKwh is provided in the scan request. Also documents the special self-sufficiency pricing rule. These tiers are based on current Dutch market data (2026).

Response

Request

GET

/v1/batteries/cost-tiers

curl -G https://api.enhub.nl/v1/batteries/cost-tiers \
  -H "x-api-key: {your-api-key}"

Response

{
  "tiers": [
    {
      "label": "≤ 5 kWh",
      "maxKwh": 5,
      "costPerKwh": 600
    }
  ],
  "selfSufficiencyCostPerKwh": 0.01,
  "currency": "EUR"
}

GET/v1/batteries/presets

Get battery preset configurations

Returns fixed-size and range-based battery presets for the scan wizard, plus recommended defaults for advanced settings (min SOC, roundtrip efficiency). Use these presets to populate the battery selection UI.

Response

Request

GET

/v1/batteries/presets

curl -G https://api.enhub.nl/v1/batteries/presets \
  -H "x-api-key: {your-api-key}"

Response

{
  "fixedPresets": [
    {
      "id": "5",
      "label": "Klein",
      "kwh": 5,
      "powerKw": 2.5,
      "recommended": true
    }
  ],
  "rangePresets": [
    {
      "id": "range-20",
      "label": "Tot 20 kWh",
      "maxKwh": 20,
      "maxKw": 10
    }
  ],
  "defaults": {
    "minimumChargeLevel": 20,
    "roundtripEfficiency": 95
  }
}