Tank Utility
Add Tank Utility
Setup
Authentication
Authentication for the Tank Utility API is performed with the same email and password credentials used at https://app.tankutility.com
Devices
Each item in the list of devices is a 24 character string. These values can be found by clicking on the Usage Reports link at the bottom of the graph on the Tank Utility devices page
The device item value is the last segment of the URL path, e.g., the URL
https://app.tankutility.com/#/reports/000000000000000000000000000000000000000000000000
as a device value.
Using TankUtility API to Obtain Device ID
-
Obtain your personal token:
curl --user <my_username>:<my_password> https://data.tankutility.com/api/getToken
The JSON response structure should resemble:
{"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE0MzgyMjQwODE0NjIsInYiOjAsImQiOnsidWleejoic2ltcGxlbG9naW46MzM1In0sImlhdCI6wwDIyMzk5NX0.kbYzxRtbGB2ke3IBgQTVMNQprHOWJZFgQQnPK6Wyas4"}
-
Receive the list of devices you have in your account:
curl https://data.tankutility.com/api/devices?token=<my_personal_token>
The JSON response structure should resemble:
{"devices":["54df6a066667531535371367","54ff69057492666782350667"]}
Configuration
To enable the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more], add the following lines to your configuration.yaml
The configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file.
After changing the configuration.yaml
The configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.
# Example configuration.yaml entry
sensor:
- platform: tank_utility
email: YOUR_EMAIL_ADDRESS
password: YOUR_PASSWORD
devices:
- "000000000000000000000000"
Configuration Variables
Your https://app.tankutility.com
Your https://app.tankutility.com