Get Tank Readings

Fetch tank level readings from Anova tank monitoring systems using a report ID.

Operation

getTankReadings

Parameters

Parameter	Type	Required	Default	Description
Report ID	string	Yes	-	The ID of the Anova report to fetch

Response

Success

Returns an array of normalized tank data records:

{
  "tank_id": "TANK001",
  "tank_name": "Main Propane Tank",
  "tank_size": 1000,
  "reading_id": "RDG12345",
  "reading_time": "2024-01-15 14:30:00",
  "reading_volume": 650.5,
  "reading_inches": 42.3,
  "owner_name": "Acme Corp",
  "customer_id": "CUST001",
  "ship_to_code": "SHIP001",
  "location_name": "Main Facility",
  "location_address": "123 Industrial Way",
  "gps_latitude": 32.7767,
  "gps_longitude": -96.7970,
  "product_name": "Propane",
  "product_sku": "PROP-001",
  "sensor_value": 65.5,
  "daily_usage": 15.2,
  "available_capacity": 349.5,
  "average_daily_usage": 14.8,
  "days_to_empty": 43,
  "fill_percentage": 65,
  "fill_status": "Normal",
  "alert_status": "None"
}

Error

{
  "error": "Anova credential is missing apiUrl",
  "record": {}
}

Response Fields

Field	Type	Description
tank_id	string	Unique tank identifier
tank_name	string	Human-readable tank name
tank_size	number	Tank capacity in gallons
reading_id	string	Unique reading identifier
reading_time	string	UTC timestamp of the reading
reading_volume	number	Current volume in gallons
reading_inches	number	Current level in inches
owner_name	string	Tank owner name
customer_id	string	Customer identifier
ship_to_code	string	Shipping location code
location_name	string	Location description
location_address	string	Physical address
gps_latitude	number	GPS latitude coordinate
gps_longitude	number	GPS longitude coordinate
product_name	string	Product stored in tank
product_sku	string	Product SKU
sensor_value	number	Raw sensor reading
daily_usage	number	Daily consumption rate
available_capacity	number	Remaining capacity
average_daily_usage	number	Average daily consumption
days_to_empty	number	Estimated days until empty
fill_percentage	number	Current fill level (0-100)
fill_status	string	Status description
alert_status	string	Current alert state

Error Handling

• Missing API URL: Anova credential is missing apiUrl
• Missing API Token: Anova credential is missing apiToken
• Invalid Report ID: Returns empty array if report not found
• API Timeout: Request times out after 600 seconds