--- title: "FoxESS OpenAPI" description: "FoxESS OpenAPI is a Marketplace integration for Home Assistant. It has 50 installs sharing analytics, needs the vendor's cloud and was last updated August 1, 2026." canonical: "https://vulpo.app/integrations/marketplace/fruffin-home-assistant-foxess-openapi" url: "https://vulpo.app/integrations/marketplace/fruffin-home-assistant-foxess-openapi.md" last-updated: "2026-11-08" version: "1.4" --- # FoxESS OpenAPI > FoxESS OpenAPI is a Marketplace integration for Home Assistant. It has 50 installs sharing analytics, needs the vendor's cloud and was last updated August 1, 2026. FoxESS OpenAPI is a custom integration that reads FoxESS solar and battery systems through the FoxESS Open API. It creates a Home Assistant device for the configured inverter serial number and adds sensors for inverter status, PV strings, phase metrics, battery state, power flows, temperatures, daily energy totals, and API response time. Refresh intervals are exposed as number entities on the device, so they can be changed from its details page, and a button forces an immediate refresh of all datasets. Calls go through a shared coordinator and are spaced at least one second apart because the FoxESS API is rate limited. Support for PV strings 7 to 18 is optional, and second-battery sensors appear only when FoxESS reports values for them. Setup happens in the UI with an API key from FoxESS Cloud and the device serial number, and the integration depends on the vendor's cloud. Automatic summary of the README and code of fruffin/home-assistant-foxess-openapi. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/support) [Open in My Home Assistant](https://my.home-assistant.io/redirect/marketplace_repository/?owner=fruffin&repository=home-assistant-foxess-openapi&category=integration) On Home Assistant 2026.10 or older? [Open it in HACS](https://my.home-assistant.io/redirect/hacs_repository/?owner=fruffin&repository=home-assistant-foxess-openapi&category=integration) ## Supports - **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Connect - **API key** - **Device serial number** - **Expose PV strings 7-18** - **API host** - **Name** ### After setup - **Expose PV strings 7-18** Texts from the code of [fruffin/home-assistant-foxess-openapi](https://github.com/fruffin/home-assistant-foxess-openapi). ## From the README > Custom Home Assistant integration for FoxESS solar and battery systems using the FoxESS Open API. > > FoxESS OpenAPI is config-flow first, creates a proper Home Assistant device for the configured inverter serial number, and exposes sensors for inverter status, PV strings, phase metrics, battery state, power flows, temperatures, daily energy totals, and API response time. > > - UI-based setup; no YAML configuration required. > - Home Assistant device metadata based on the configured FoxESS serial number. > - Configurable refresh intervals from the device details page. > - Force-refresh button for ad hoc API updates. > - Optional support for extended PV strings up to PV18. > - Optional second-battery sensors are only created when FoxESS reports values for them. From the README of [fruffin/home-assistant-foxess-openapi](https://github.com/fruffin/home-assistant-foxess-openapi#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries - Brand: [FoxESS](https://vulpo.app/integrations/foxess.md) - Number: 50 installs sharing analytics; 1 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v0.5.0, last updated August 1, 2026 - Domain: `foxess_openapi` - Source: - Issues: In Vulpo: Button card, Chart card, Apple Watch ## Other ways in for FoxESS | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [HA & FoxESSCloud integration](https://vulpo.app/integrations/marketplace/macxq-foxess-ha.md) | Marketplace integration | 1.6k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [FoxESS - Modbus](https://vulpo.app/integrations/marketplace/nathanmarlor-foxess-modbus.md) | Marketplace integration | 1.4k installs sharing analytics | Works locally | Updated in the last 6 months | | [FoxESSCloud API](https://vulpo.app/integrations/marketplace/softxperience-home-assistant-foxess-api.md) | Marketplace integration | 284 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [FoxESS Control](https://vulpo.app/integrations/marketplace/nicois-foxess-control.md) | Marketplace integration | 130 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [FoxESS T Series](https://github.com/LucasTor/FoxESS-T-series) | Marketplace integration | 11 installs sharing analytics | Works locally | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-11-08. Source: https://vulpo.app/integrations/marketplace/fruffin-home-assistant-foxess-openapi --- - HTML version of this page: https://vulpo.app/integrations/marketplace/fruffin-home-assistant-foxess-openapi - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml