Enphase envoy local api.
The batteries are set up in the envoy box.
Enphase envoy local api They were installed a bit over a month ago. Jul 10, 2023 · I don't know whether Enphase is doing it on purpose but the in sake of the argument "security improvement" local access is killed more and more with every new firmware update. If your Enphase Cloud login is associated with multiple systems or if the system has multiple IQ Gateways, then select the system and the serial number of the IQ Gateway which requires access via local API in the “Select System” and “Select Gateway” drop-downs respectively. I notice that Enphase envoy (with firmware D7. The Enphase Envoy integration is used to integrate with the Enphase IQ Gateway, a communication device for Enphase solar inverters and batteries. This project is focusing primarily on the Enphase® "IQ Gateway" (formerly "IQ Envoy") system, the gateway for Enphase®'s IQ6, IQ7 and IQ8 Microinverters used on solar panels to convert Direct Current (DC) to Alternating May 1, 2022 · During vendor selection I reviewed the access and APIs available; and Enphase seemed to have a good mix of capabilities. An application for polling the Enphase Envoy for power information and storing it into a database. This caused many home automation and data logging integrations to break. I have a new Enphase system and reading my Envoy using the local API. I was told by support they would have a new method of local control coming at the end of January but it required connecting to the Envoy AP which I don't think will The Enphase Envoy integration is used to integrate with the Enphase IQ Gateway, a communication device for Enphase solar inverters and batteries. com/download/accessing-iq-gateway-local-apis-or-local-ui-token-based-authentication Prior, I accessed http://<envoy>/stream/meter but that seems to no longer be available with https and the 'token' way of getting at things. enphaseenergy. Find answers, ask questions, and connect with the solar community of Enphase users worldwide. local). Hello ascent, Apologies for the delayed response. Edit: Wanted to add that this token requirement means you can't use the Enphase local API if it doesn't have internet access correct? Somewhat defeats the purpose of a local API. As part of a typical Enphase solar installation, you would have had an Enphase Envoy installed. Could that be added? (the data clearly exists in the installer dashboards). com)" Jan 29, 2016 · This is my first attempt at creating and releasing a device type - a power & energy meter for a solar system running Enphase inverters. But when I do a RESTapi call to https://envoy. I want to use Local REST api call doens't return a value Yesterday my brand new Enphase system got installed. U can present Voltage as avarange Value ( (L1+L2+L3)/3) or phase to N or phase to phase. 4 Frontend 20240610. From the Enlighten Cloud page I can download the various reports, inc the Monthly overview of: Production, Usage, Import & Export. However, trying to add logic that will automatically renew the token if expired. local to register an API key for my system, but when I login to get an API key, my system is not listed. x)</p><p> </p><p>I have worked out how to interactively obtain a JWT token that I can paste in to the local envoy website At Enphase, we create high-quality solutions that meet the highest security standards. The Envoy metered is a type of Envoy that next to production also measures data for import/export and consumption. In this case, the maxReportWatts displaying a value of 222 represents an older value, the maximum wattage value reported previously. local it tells me the site is not secure and when I proceed it shows an error, which I can acknowledge and then even after I enter in a token (which I'm forced to do Since I updated my Envoy to D7. The system controller contains an Envoy with firmware D8. I assume you already tried that. Jan 21, 2022 · <p>With the developing difficulty of obtaining realtime, local data relevant to solar system performance and home automation integrations I'd like to suggest the addition of an MQTT client to the Envoy to communicate every 60 seconds relevant system stats (solar production, power consumption, grid export). The consumption is chosen to be either total or net depending upon the position of the consumption CT installation. again, all normal. Enphase is a brand of solar microinverters and batteries. From my wifi router i can't access to `envoy. local may cause your browser to warn you that the connection is not secure, but just bypass the warning. , D7. If U look on the energy meter no one get Voltage output as summary of 3phase. See full list on github. 0 Commercial Critical updates Storage Support Homeowners Installers Enphase Community Training events Warranty and Why doesn't the local API on the Envoy S Metered update the consumption and production values until I access the web interface "live status"? Jun 17, 2023 · I know there is a lot of confusion with all of the forks of the Enphase integration because of the authentication switch with the update to firmware 7. Has anyone been able to use the Local API with the JWT token Why am i still unable to pull daily, weekly and lifetime production data from local API with homeowner token? Envoy Local Interface If your Envoy is connected to your router, go to step 3. Apr 7, 2024 · If I play with API (using programming language) or using Home Assistant, after some minutes, API and Enlighten mobile application stop working as expecting. com port 443 proto tcp Ensure your Envoy’s local IP is whitelisted in your firewall for API calls. I can access only connecting me on gateway wifi ENVOY_SERIAL, but i must connect form my router wifi to get data for my domotic system. 2. . Is there a new local API for the current enphase envoy that was installed this week? Translate with GoogleShow OriginalShow Original Choose a language Home Energy Management New Local API Current Enphase Envoy Like Answer Share 7 answers 562 views I want to use 'evcc' together with my Envoy local API endpoint /ivp/livedata/status , but I am facing the same 15 minute time out problem. in Homey Pro (when installed) wants to make locally contact the envoy, then when you want to make the connection you need to fill in the user-iD and de API key (not an token) to make the connection to the envoy. Since it's not possible to gather current or total charge and discharge rates of the battery, I'm constantly (5x per minute) polling the /ivp/livedata/status endpoint. Make the energy sensor to use in the Energy Dashboard At Enphase, we create high-quality solutions that meet the highest security standards. This does not appear to be live data. Looking at local web interface, everything sounds ok : Metering part : Metrics are updating and displaying last minute date time Monitoring Green check on "Connected to Enlighten Jul 1, 2024 · Hi everyone, I am running the latest HA version Core 2024. 4 Supervisor 2024. 88 (5580b1)) is resetting th… A client library for the Enphase Envoy local API. Several of our installers and homeowners use local APIs or local UI on the Gateway to access data. The wallbox should only charge the car, when there is enaugh energy. Feb 9, 2023 · @Ananth Karthik (Moderator) Unfortunately the official Enphase integration in Home Assistant does not appear to be working with the new token requirement - the updated firmware has locked it out. Local Envoy API access to change settings It would be great if I had local API access to my Envoy in the event of: No cell service or internet service due to power outages or location, and maybe not having the ability to go through the manual l Envoy AP button press mobile app connection process every time you want to make a change. 17. Connect the other end of the network cable to the RJ45 network (Ethernet) port of a computer. TLDR: I want to be able to manually start charging of my 5P batteries, either in the Enlighten app or via the API. In this documentation, as well as in integration entity names, the Enphase IQ Gateway is commonly referred to as Envoy, a name from the conception times of this integration and retained for its I'm happy there is a local API on the Envoy (vs using the installer API on the PVS) but the Envoy API is missing detailed inverter data (temp, ac/dc v,a). These interfaces were in the past protected by conventional password-based authentication. local` or ip address directly Both failed after 2minutes timeout. This API is designed for large companies to build integrations with Enphase products. Is there a possibility to exclude it, so that the consumption co When querying the envoy directly, one can use https://envoy_local/ivp/ensemble/inventory which will show the battery status and levels, but there doesn't seem to be an equivalent using the API. The access Yes, my output is 3 phase, as summary output can be only Power, Current, Energy but Voltage need to be (phase1 + phase2 + phase3)/3 = avarange output. It only gets reset either after IQ Gateway reboots or after the eSW upgrade. Jul 25, 2022 · TL;DR Envoys that are upgraded to firmware D7. But my firmware version is new, I was unable to use the driver provided in this forum. Hi @Imming_8296 As per the discussion in Access IQ Gateway via curl not fully working - Community | Enphase, a similar issue was being faced and it got resolved with fresh generation of token and accessing the URL. Searching the internet, I find many users who have managed to discover quite some things, but nobody seems to just have the definitive set of API endpoints. Sep 26, 2023 · I have two Enphase IQ Battery 5P units and an IQ System Controller. com/download/iq-gateway-access-using-token-tech-brief), I am trying to access the local api of my Envoy-S-Metered. If you're an Enphase customer and want to throw support behind the idea, can you throw your support behind this thread on the Enphase support forum? Jun 11, 2021 · Idem hier, binnenkort gaat ook mijn zelf aangelegd enphase systeem live; ben je intussen wat wijzer geworden hoe de nieuwe firmware tegen te houden (zodat local api's calls mogelijk blijven), terwijl een nieuw systeem (online) ingeregeld moet worden? Sep 27, 2022 · Hey fellas, I just got my Hubitat C-7 and wanted to connect to my Enphase Envoy-S (monitored). 66 which has the new authentication mechanism for the local API. </p><p>Additionally . As per stated in that forum discussion and also in the tech brief, 'You need to generate an access token and save it every 12 month. Apr 17, 2025 · Working on home energy data retrieval from the Envoy API. This seems like a step back. Our team has responded with the following information, maxReportWatt doesn’t get reset everyday. x and later no longer have unauthenticated access, default credentials, or an easily crackable installer login - instead, you need to grab a JWT from the enlighten site. Until the integration is updated to allow for the new token/API requirements, we appear to have lost the ability to monitor our systems through Home Assistant. com Envoy. Should there be a password? Mar 29, 2023 · For <Envoy URL>/stream/meter, the Envoy-S Metered must be used instead of the Envoy Standard. local/ivp/livedata/status. Although the batteries are working correctly, the Envoy is acting like they don't exist: 1) On the home page (https://<my IP>/home) "Consumption" is incorrectly reported and lumps battery charge/discharge along with Home Energy ManagementNoonan_9979August 4, 2023 at 1:32 PM Number of Views 82 Local Envoy API access to change settings Feature RequestWestlye_7651November 6, 2022 at 3:17 PM Number of Views 648 Allow these domains: bash sudo ufw allow out to api. This device tracks the power production of your system Rest API: live data appears to be dead In the Enphase document https://enphase. Enphase-API is an unofficial project providing an API wrapper and the documentation for Enphase®'s products and services. The default documentation says the user name is envoy and the password is blank. Is this token based authentication required for the iQ Combiner? Definitely something that makes me hesitate betting Enphase. The Envoy Standard has a meter built in which helps get /stream/meter data. Up until about 2 weeks ago I could load envoy. Use the Gateway’s built-in Wi-Fi or AP Mode to connect. ENPHASE_LOCAL_API_JWT -- If you set all the environment variables defined above the enphase-proxy will, at startup and then periodically thereafter, hit the Enphase Enlighten system and get a new JWT. So while the good news is that we do still have local access, the bad news is that the token acquisition process is sketchy at best. It connects to the Enphase Envoy on the local LAN and thus is not bound to any rate limits or contingent on setup of a developer account with Enphase. Any other solutions available or news on progress Nov 6, 2022 · Solar for business Case studies Get Enphase Installers Training Communication System builder Microinverters EV chargers Accessories Apps Documentation Resources O&M Marketplace Leads Program Enphase API Grid Services Platform NEM 3. Track and monitor JustPoet November 16, 2022 at 2:01 AM 4. Now I fail to connect to the Envoy-S-Standard-EU unit on HTTP and HTTPS ports with error, "No route to host". Many installers and homeowners use local APIs or local UI on the IQ Gateway to access data. 76 K Hello. 7x) I created a Python application/script that uses the gateway API (currently the ‘local’ one, so not (yet) through the Enphase ‘cloud’ API) to get data out (currently, the current power and the energy during the day). </p><p> </p><p>This would be an easy method for home automation platforms to obtain what Hello Enphase, Recently your micro-inverters and Envoy-S metered gateway has been installed at my home. Thanks! Enphase-API is an unofficial project providing an API wrapper (including local/LAN Gateway API) and the documentation for Enphase®'s products and services. The documentation was not exactly cleared and I spent some time reading a lot of information both in Enphase as well as everywhere on the internet. I have managed to make this work via using Restful commands. Apr 23, 2025 · In this tutorial, we will show you how to connect your Enphase Envoy to Home Assistant. Jun 30, 2025 · enphase-influx enphase-influx is a tool to fetch solar production data from the Enphase Envoy local API and import it into an InfluxDB database. json) , consumption includes battery activity. <p>My envoy is running 7. 2 Operating System 12. x. I have created a Postman collection to showcase how to retrieve JWT Token to access data from Envoy Gateway in local network. Stay updated with Enphase News, participate in the discussions, and read articles about Enphase products and services. This now requires an access token and I have this working. While one of the pricier solar power solutions, they are known for being of high quality. Since Enphase developed the API, and since the API is for end users, it would make sense for Enphase to provide the full API documentation to its end Find answers, ask questions, and connect with the solar community of Enphase users worldwide. Enphase Energy systems are really not meant for offgrid only; they are truly meant for grid-connected scenarios with offgrid capability once the grid becomes inoperable. Apr 15, 2023 · I have an Enphase Envoy hub for my solar PV system and I’m trying to get the local data into openHAB 3 running on Window 10. Is there a software upgrade that I can apply to have more API functions on my local Envoy? As requested, here are the errors that flag. com) LikeLikedUnlike Translate with GoogleShow OriginalShow Original Choose a language Get started with Enphase Envoy Solar Monitoring Local Access documentation from Enphase exclusively on the Postman API Network. According to the Manual "Accessing IQ Gateway local APIs and local UI with token-based authentication (enphase. Use Commissioning API to integrate with Enlighten and reduce activation time. @Doe_1560 Yeah, I hear you. Also, we would like to inform that we no longer support Envoy API and recommend you to use the Enlighten API for which the Enphase API Use Monitoring API to retrieve Enphase system performance data and gain insights. As a consequence Enphase makes device owners slowly but surely more and more dependant on Enphase services. I went to envoy. Select your system name and IQ Gateway serial number. The login website is broken and you cannot get a "commissioned system" token via the site, you can get an uncommissioned system token which acts the same way, they are only valid for 12 hours and will need to be renewed frequently. The recent firmware update to my Envoy S gateway that was pushed by Enphase without my consent has now restricted local API connectivity and broken my home automation setup. local with the IP of your envoy box. <p>Hi,</p><p> </p><p>I‘m really frustated wirh my enphase system. For home use, you can just use the Envoy local API Nov 9, 2025 · Enphase Envoy integration reports daily timeout while local API remains reachable (firmware D8. See more details below. Accessing IQ Gateway local APIs or local UI with token-based authentication (enphase. Otherwise, follow the steps below: Using the network cable provided, connect one end to the Ethernet port on the Envoy. A few notes Jul 18, 2023 · I wrote scripts to query the local API at my Envoy-S-Standard-EU unit and was it was working well until today. I see that others have much more features via API calls, I can only call ip/API/V1/production. I can't access "direct status" from Enlighten mobile app. 6. Which works quite well most of the time. I am running Sunlight Backup, and my IQ8's are grid-forming during the day, BUT my cellular modem can connect to the Enlighten cloud always, and my System Combiner 4c with integrated IQ Envoy Enphase-API is an unofficial project providing an API wrapper (including local/LAN Gateway API) and the documentation for Enphase®'s products and services. If the Envoy has an LCD display, enter the IP Enphase-API is an unofficial project providing an API wrapper (including local/LAN Gateway API) and the documentation for Enphase®'s products and services. 0. local when I was connected to my home network and it would automatically load a status/production page of my system, now when I visit envoy. This was inspired by this post (with the linked code unfortunately no longer being available). My system is reporting on the app, but not giving live status. For me this is bug in Envoy software. I have the CURL command and token part working and if I run the following in an elevated Windo… In the Local Envoy API (production. Aug 15, 2023 · Enphase-API is an unofficial project providing an API wrapper and the documentation for Enphase®'s products and services. </p><p>Unfortunately, especially when the PV production rises quickly, the response is not readable with PHP curl anymore. In this state as it is I need to divide : Yes, we do have an API team support email address, however, it works only for Developer APIs (Enlighten API) and not the Gateway local API. Is there a possibility to exclude it, so that the consumption contains only what the house is really consuming ? With local internet, you can go to envoy. <p>I have a question regarding the local API. I created the API token (via entrez-auth-token?serial_num), and I am able to login with the API key to the local URL (envoy. txt I have an Enphase micro inverter installation and would like to use the Homey SolarPanels App to integrate data that the Envoy Metered produces into my Homey. 5167) #156189 Technically, there 'is' local control for scenario #1, but it requires manually opening the physical Enphase IQ panel, resetting the AP (so Envoy stops connecting to the wifi), and operating the mobile app from in-front of the panel. json file or any production API endpoint. Unfortunately this means that all the tools for interacting with the local envoy in an automated fashion need to be updated (I think most I have found appear to be designed for 5. This driver simply can fetch the solar production data (now How do I get reliable real time consumption/ production readings from the Envoy on a per second basis? The Envoy has 6 CTs permanently measuring activity. Selected as Best LikeLikedUnlike Translate with GoogleShow OriginalShow Original Apr 17, 2025 · Possibilitiy to access local API without Token from enphase Solar Hoeck_9026 July 16, 2023 at 12:03 PM Number of Views 428 We would like to show you a description here but the site won’t allow us. 06. @mallapitchai (Moderator) : What does 'The gateway’s local API must be called at specific intervals to get current data. Current profiles don't provide enough flexibility. Aug 9, 2023 · Morning @Siddharth Shankar (Moderator) , I am experiencing the same problem as topic starter and only today got to testing your proposed solution, but despite being able to view the /ivp/pdm/production manually and despite my script having a valid token, I am unable to use neither /ivp/pdm/energy nor ivp/pdm/production. y) have had issues with local token validation, especially if the Gateway (Envoy) loses internet access temporarily. g. 223774952. This is failing. I use the cURL function such as: About Enphase-API is an unofficial project providing an API wrapper (including local/LAN Gateway API) and the documentation for Enphase®'s products and services. 1 and just got my enphase system 🙂 Everything seems to be working fine, but I don’t see the battery charge and discharge entities as mentioned in the docs: For Energy going into the battery, use the the Envoy Lifetime battery energy charged entity. Should there be a password? - Community | Enphase What is the Username and Password for the Administration page of the Gateway local interface? - Support | Enphase Running Dec 4, 2024 · Hi all, I recently got an enphase system and batteries and was disappointed to learn that the home assistant integration doesn’t work in the UK. Both return a 401. I have Envoy-R-EU, software version 3. For Server Sockets Enabled, websockets, they are not available along with Envoy local REST APIs. local in your browser paste the token you got from entrez. 1678687434-1765750934. How can i reach gateway api from my router wifi? I'm updating my local monitoring scripts to adhere to the new way of doing things specified in https://enphase. local/ivp/meters/readings, it returns only ' []'. Apr 25, 2023 · Hi @Froehlich_3094 You can refer to the below link for more details. Open the Internet browser application on the computer. I know it’s not quite using the local api, but it may still be useful for automations for some. Since the above driver still works with the most of the Envoy devices, I wanted to create a simple driver that works with Envoy devices with new firmware. We can't find the local API key in our system which we need to make connection. Oct 20, 2025 · Enphase should support Home Assistant with a first party (Enphase) written integration, supporting fully local communications. Referring to this document (https://enphase. I understand the following wrt Envoy: the Envoy collects each 5 minutes the data and uploads each 15min to the Enlighten Cloud If the Envoy is disconnected from The following guide walks you through how to generate an API key. 22. The app. Enphase Envoy Solar Monitoring Local Access on the Postman API Network: This public collection features ready-to-use requests and documentation from Enphase. 207755409. For Energy coming Mar 9, 2023 · Since the standard Envoy HA integration doesn’t support the newest firmware (0. Some Gateway (Envoy) firmware versions (e. Is there any update on this? I'm also looking for complete documentation of the API. com/download/accessing-iq-gateway-local-apis-or-local-ui-token-based-authentication?_ga=2. In this documentation, as well as in integration entity names, the Enphase IQ Gateway is commonly referred to as Envoy, a name from the conception times of this integration and retained for its Connect to the same LAN (local area network) as the Envoy S or IQ Gateway to access the Gateway’s interface. </p><p> </p><p>The most shocking thing for me is, that I can only have access to my gateway with the help of the enphase oauth servers. I need to access the local API to control a wallbox. local, if it isn’t, you can replace envoy. Jul 10, 2020 · Enphase Envoy Local API output. At some point in late 2021/early 2022 access to a local Envoy gateway was changed to require a JWT access token. com Apr 23, 2023 · Note: this assumes your envoy box is on the same LAN as your HA instance and is reachable with the default address of envoy. 1676903595 it provides the API for the REST command https://envoy. local/ivp/pdm/energy the consumption numbers do not add up with what I know my usage is and what the Enphase app shows. The batteries are set up in the envoy box the system is functioning normally but I'm not seeing any data populated in the storage object (Local API). </p><p>Now I need a bearer Token to access the local API. 130 (91f206), I am unable to get access to the production. The Enlighten Systems API - Harness the power of data from Enphase Systems. 3. How do you set up Enphase Envoy in Home Assistant? Home Assistant finds the Envoy, but gives an "unexpected error" during configuration. May 4, 2023 · Hi folks, This issue is not directly related to HomeAssistant or my own installation, but I see this issue with 2 installations from friends. Our support team is committed to provide assistance on any queries/concerns that the customers reach out to us with, even if it is out of their scope. The production can be measured via both microinverters and the Envoy meter separately and that is what you will see in the Envoy local interface. Opening up the local API would mean the open source community throwing together containers for r/homeautomation, plugins for r/homeassistant, and more great ways to get Cloud-less control. I was able to solve this using the REST sensor - no enphase integ… In the Local Envoy API (production. This goes well for one endpoint but not for another. Above is a screenshot taken today when I pull from the local API, from: https://envoy. The enlighten app shows the batteries (charging/discharging). snltpzsiatdnjvpdstmtqrtaeafowrorkjtwolrosvtbtgkzrowamebgkbostvozqphdjnmagk