Canonical Data — JSON API

Machine-readable snapshots of the BMS-EV product catalog. Regenerated from the WooCommerce database of shipping SKUs.

These files are the single source of truth. The Compatibility Matrix, battery/inverter reference pages, docs.bms-ev.com/llms.txt, and the GitHub CSV mirrors are all derived from these three JSON documents. If a number differs between pages, this data set is canonical.

Available datasets

/data/batteries.json — 73 battery profiles (68 OEM EV pack variants + 5 DIY BMS profiles), sorted alphabetically, with compatible-inverter counts
/data/inverters.json — 56 hybrid inverter variants, sorted alphabetically, with compatible-battery counts
/data/compatibility.json — full 3815-row database of battery × inverter combinations

Also available in CSV

GitHub mirror: github.com/BMS-EV/bms-ev-docs hosts the same data as CSV files (batteries.csv, inverters.csv, compatibility.csv) for spreadsheet import.

Schema

compatibility.json entry

{
  "battery": "Tesla Model 3 & Y (all sizes) (All)",
  "inverter": "SOFAR HYD 5-20KTL-3PH",
  "status": "in_catalog",
  "sku_available": true,
  "verification": null,
  "verification_date": null,
  "firmware_min": null,
  "notes": null
}

Fields:

battery, inverter: canonical name from BMS-EV product catalog
status: in_catalog (SKU shipping), experimental, or not_supported
sku_available: whether a controller ships pre-configured for this pair today
verification: tested_by_bms_ev, customer_verified, experimental, or null (see Verification levels)
verification_date: ISO date of most recent verification, or null
firmware_min: minimum BMS-EV controller firmware version required, if known
notes: free-text technical notes

Generated: 2026-09-18. Regenerated automatically when the product catalog changes. Do not edit these files by hand — modify the source catalog instead.