The Enlighten Systems API

I have an account on The Enlighten Systems API. Can I use the same login credentials on The Enlighten Systems API ? +

The Enlighten Systems API is an independent portal from The Enlighten Systems API. The user must sign up for the developer-v4 portal as a new user and create applications from The Enlighten Systems API to access the application credentials - API Key, Client ID, and Client Secret. The login and application credentials of the developer-v2 portal will not give automatic access to the developer-v4 portal.

What are the available plans, and which one should I choose? +

If you are an Enphase Installer, the ‘Partner Plan’ is recommended. For more details, please refer to the Enlighten Systems API page.
If you are not an Enphase Installer, you can choose one of the ‘Watt’, ‘Kilowatt’, or’ Megawatt’ plans. For more details, please refer to the Enlighten Systems API page.

I am an Enphase Installer. How can I access the API? +

The Partner plan is recommended for Enphase Installers. The plan is available only for Enphase installers with at least 10 installations. Partner plan provides access to all the endpoints available on the portal for your installed and maintained systems. Generate access and refresh tokens using your application (Client ID and Client Secret) and Enphase Cloud credentials ( Enphase Energy - Enlighten | Sign in to Enlighten ). Enphase Cloud credentials, not developer account credentials, must be used to generate the tokens. The steps to subscribe to the Partner plan and generate tokens are available on the following page - The Enlighten Systems API.
Since the Partner plan is a paid plan, users can enter their credit card details on the following page – Enter Payment Details.

I am a developer. How can I access the API? +

If you are not an Enphase homeowner or installer, the recommended plans are Watt, Kilowatt, and Megawatt. To access the API, developers must get authorization from the system owner. The steps to subscribe to the developer plan and generate tokens are available on the following page - The Enlighten Systems API.
Since the Watt plan is free, users can create applications under it without providing any payment details. To subscribe to the Kilowatt or Megawatt plans, credit card details must be entered on the following page – Enter Payment Details.

I am an Enphase homeowner. How can I access the API? +

Homeowners can subscribe to the Watt plan to access the API for free. The homeowner must sign up independently to retrieve the Auth code and generate tokens. Users can subscribe to the Kilowatt plan for higher usage requirements.

Which endpoints should I use to access all my systems details? +

/api/v4/systems endpoint can retrieve all the systems a user has access to.
/api/v4/systems/{system_id}/summary endpoint can retrieve a summary of an individual system.
/api/v4/systems/{system_id}/devices can be used to retrieve the details of a particular system's devices.

Which endpoints should I use to retrieve the production data? +

/api/v4/systems/{system_id}/telemetry/production_meter endpoint can retrieve site-level energy produced in 15 min intervals as measured by the production meter installed on the site. The date range for a single API request is restricted to a maximum of 7 days, and the start date must be within 2 years from the current time.
/api/v4/systems/{system_id}/production_micro endpoint can retrieve site-level energy produced in 5 min intervals as measured by the production micros installed on the site. The date range for a single API request is restricted to a maximum of 7 days, and the start date must be within 2 years from the current time.
/api/v4/systems/{system_id}/energy_lifetime endpoint can be used to retrieve site-level energy produced in daily intervals. There are no restrictions on the date range for a single API request.

Which endpoints should I use to retrieve the consumption data? +

/api/v4/systems/{system_id}/telemetry/consumption_meter endpoint can retrieve site-level energy consumed in 15 min intervals as measured by the consumption meter installed on the site. The date range for a single API request is restricted to a maximum of 7 days, and the start date must be within 2 years from the current time.
/api/v4/systems/{system_id}/consumption_lifetime endpoint can be used to retrieve site-level energy consumption in daily intervals. There are no restrictions on the date range for a single API request.

Which endpoints should I use to retrieve the battery data? +

/api/v4/systems/{system_id}/telemetry/battery endpoint can retrieve site-level battery energy charged and discharged in 15 min intervals. The date range for a single API request is restricted to a maximum of 7 days, and the start date must be within 2 years from the current time.
/api/v4/systems/{system_id}/battery_lifetime endpoint can be used to retrieve site-level battery energy data in daily intervals. There are no restrictions on the date range for a single API request.

Which endpoints should I use to retrieve the grid export data? +

/api/v4/systems/{system_id}/telemetry/energy_export_telemetry endpoint can be used to retrieve site-level energy exported in 15 min intervals. The date range for a single API request is restricted to a maximum of 7 days, and the start date must be within 2 years from the current time.
/api/v4/systems/{system_id}/energy_export_lifetime endpoint can be used to retrieve site-level energy export data in daily intervals. There are no restrictions on the date range for a single API request.

Which endpoints should I use to retrieve the grid import data? +

/api/v4/systems/{system_id}/telemetry/energy_import_telemetry endpoint can be used to retrieve site-level energy imported in 15 min intervals. The date range for a single API request is restricted to a maximum of 7 days, and the start date must be within 2 years from the current time.
/api/v4/systems/{system_id}/energy_import_lifetime endpoint can be used to retrieve site-level energy import data in daily intervals. There are no restrictions on the date range for a single API request.

How can I contact Enphase API support? +

Please email us at api@enphaseenergy.com if you have any questions.

List of Resources: +

FAQ

Account Management:

Pricing and Plans:

Telemetry Data:

List of Resources: +