Articles in this section

How To use the Tigo Energy API

  • Updated

Notes:

  1. API access requires a Premium data subscription.
  2. Tigo does not offer the acquisition of report data directly from our Loggers.

Overview:

  1. System reports are stored on a server after the interpretation of the encrypted data reports.
  2. System data is retrieved using this API (Application Programming Interface). 

An attached pdf document (below) describes the protocol used by the Tigo Energy API. 

 

How-To Access:

  • The login name is a user's name used to log in to view a system.
  • A login name can be any string but is often a users email: joesmith@xyz.com

1. First, login-in into the server to confirm authorization to access a system's data using an OS command prompt:

#!/bin/sh
#curl -u "<login-name>:<password>" "https://api2.tigoenergy.com/api/v3/users/login"

The server will respond with a "auth" (authorization token) string that is similar to:

{"user":{"user_id":00000,"auth":"yXFqb9MQ3mOHkkR8QSNcUoxlCaJDZvJFWpLXQBA2h1lNdTFu1-m66S69H6mJo1jRzE5gi0qJTpFo2EqvMHtV0_k9XqzuVRFwaqe0XnhKI","expires":"2023-08-26T11:58:08-07:00","user_type":"Installer","refresh_token":"KITrD5rkd1bPcX-Y4412fUzEOer1ctoHePnNacE3XO0GtPsLo9SQHwAXpW7A9a8S3rlIn6-ML-blBDeOiYCR0gE-ds6E8zFrvEF6rUDCQcwLw7XJpeoTwUYgGNL","user_agreement":true}}

 

2. The "auth" string returned is used as the Bearer string in subsequent calls to the API:

 #curl -H "Authorization: Bearer yXFqb9MQ3mOHkkR8QSNcUoxlCaJDZvJFWpLXQBA2h1lNdTFu1-m66S69H6mJo1jRzE5gi0qJTpFo2EqvMHtV0_k9XqzuVRFwaqe0XnhKI" "https://api2.tigoenergy.com/api/v3/data/aggregate?system_id=20&start=2017-04-25T00:00:00&end=2017-05-02T23:59:00&level=min&param=Pin"

 END OF DOCUMENT

Related articles