Tank Utility

Add Tank Utility propane tank monitors to Home Assistant.

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/000000000000000000000000 would indicate 000000000000000000000000 as a device value.

Using TankUtility API to Obtain Device ID

  1. 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"}
    
  2. 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.yamlThe 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.yamlThe 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

email string Required

Your https://app.tankutility.com email address.

password string Required
devices map Required

All devices to monitor.