Get Tank Data

Fetch and merge tank data from ATEK systems by combining data from three API endpoints: assets, locations, and current readings.

Operation

getTankData

Parameters

This operation has no configurable parameters. It automatically fetches all available tank data from the configured ATEK API.

How It Works

The ATEK node fetches data from three endpoints in parallel:

1. Assets (/asset) - Tank asset information including IDs and categories
2. Locations (/location) - Location data with GPS coordinates
3. Current Readings (/currentAssetReading) - Latest sensor readings per asset

The data is then merged by:

• Joining assets with locations on LocationName = Name
• Joining with readings on AssetId
• Pivoting reading fields (Air Gap, Empty, FluidLevel, Full, STATUS, Temperature, Battery, % Full)

Response

Success

Returns an array of normalized tank data records:

{
  "tank_id": "ASSET001",
  "tank_name": "Tank A",
  "reading_time": "2024-01-15 14:30:00",
  "location_name": "Main Facility",
  "location_type": "Commercial",
  "gps_latitude": 32.7767,
  "gps_longitude": -96.7970,
  "foid": "FOID001",
  "alert_level": "Normal",
  "category_id": "CAT001",
  "category_name": "Propane Tank",
  "air_gap": 12.5,
  "empty_level": 0,
  "fluid_level": 850.3,
  "full_level": 1000,
  "status": "Active",
  "temperature": 72.5,
  "battery": 95,
  "fill_percentage": 85
}

Error

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

Response Fields

Field	Type	Description
tank_id	string	Asset ID from ATEK
tank_name	string	Asset name from readings
reading_time	string	UTC timestamp of last reading
location_name	string	Location name
location_type	string	Location type from locations endpoint
gps_latitude	number	GPS latitude coordinate
gps_longitude	number	GPS longitude coordinate
foid	string	FOID identifier
alert_level	string	Current alert level
category_id	string	Asset category ID
category_name	string	Asset category name
air_gap	number	Air gap reading
empty_level	number	Empty level reading
fluid_level	number	Current fluid level
full_level	number	Full level reading
status	string	Current status
temperature	number	Temperature reading
battery	number	Battery level percentage
fill_percentage	number	Current fill level (0-100)

Error Handling

• Missing API URL: ATEK credential is missing apiUrl
• Missing Username: ATEK credential is missing username
• Missing Password: ATEK credential is missing password
• API Timeout: Requests time out after 600 seconds
• Parse Errors: Returns error with original record data if transformation fails