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). 

Documentation:

  • The attached PDF document (below) describes the protocol used by the Tigo Energy API.
  • The Developer section of the Tigo EI portal contains Documentation of the REST API V3 commands. The section is only visible with Premium subscriptions; however, you can also view it at the following link: Tigo Energy, Inc | REST API V3.

 

How-To Access:

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

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

#!/bin/sh
#curl -u "<username>:<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