Skip to main content

A package to talk to growatt server

Project description

Growatt Server

Package to retrieve PV information from the growatt server.

Special thanks to Sjoerd Langkemper who has provided a strong base to start off from These projects may merge in the future since they are simmilar in code and function.


import growattServer

api = growattServer.GrowattApi()
login_response = api.login(<username>, <password>)
#Get a list of growatt plants.

Methods and Variables


Any methods that may be useful.

api.login(username, password) Log into the growatt API. This must be done before making any request. After this you will be logged in. You will want to capture the response to get the userId variable.

api.plant_list(user_id) Get a list of plants registered to your account.

api.plant_info(plant_id) Get info for specified plant.

api.plant_detail(plant_id, timespan<1=day, 2=month>, date) Get details of a specific plant.

api.inverter_list(plant_id) Get a list of inverters in specified plant. (May be deprecated in the future, since it gets all devices. Use device_list instead).

api.device_list(plant_id) Get a list of devices in specified plant.

api.inverter_data(inverter_id, date) Get some basic data of a specific date for the inverter.

api.inverter_detail(inverter_id) Get detailed data on inverter.

api.tlx_data(tlx_id, date) Get some basic data of a specific date for the tlx type inverter.

api.tlx_detail(tlx_id) Get detailed data on a tlx type inverter.

api.mix_info(mix_id, plant_id=None) Get high level information about the Mix system including daily and overall totals. NOTE: plant_id is an optional parameter, it does not appear to be used by the remote API, but is used by the mobile app these calls were reverse-engineered from.

api.mix_totals(mix_id, plant_id) Get daily and overall total information for the Mix system (duplicates some of the information from mix_info).

api.mix_system_status(mix_id, plant_id) Get instantaneous values for Mix system e.g. current import/export, generation, charging rates etc.

api.mix_detail(mix_id, plant_id, timespan=<0=hour, 1=day, 2=month>, date) Get detailed values for a timespan, the API call also returns totals data for the same values in this time window

api.dashboard_data(plant_id, timespan=<0=hour, 1=day, 2=month>, date) Get dashboard values for a timespan, the API call also returns totals data for the same values in this time window. NOTE: Many of the values on this API call are incorrect for 'Mix' systems, however it still provides some accurate values that are unavailable on other API calls.

api.storage_detail(storage_id) Get detailed data on storage (battery).

api.storage_params(storage_id) Get a ton of info on storage (More info, more convoluted).

api.storage_energy_overview(plant_id, storage_id) Get the information you see in the "Generation overview".


Some variables you may want to set.

api.server_url The growatt server URL, default: ''


This is based on the endpoints used on the mobile app and could be changed without notice.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for growattServer, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size growattServer-1.1.0-py3-none-any.whl (8.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size growattServer-1.1.0.tar.gz (7.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page