Ecovolt API - API Token Endpoints
string · requiredstring · requirednumber · min: 1 · max: 365 · requiredstring · requirednumber · requiredstring · requiredstring · requirednumber · requirednumber · required
Get room energy usage for tenant
GET
http://localhost:8080
/api/tenant/{systemId}/tenant/{tenantId}/room-energy-usage
Retrieves energy usage data for all rooms belonging to a specific tenant over a specified number of days. Returns room ID, room name, and total energy consumption in kWh for each room, sorted by energy usage (highest first).
path Parameters
systemIdtenantIdquery Parameters
daysNumber of days to look back for energy usage calculation. Maximum 365 days.
Example: 7
Get room energy usage for tenant › Responses
Room energy usage retrieved successfully
tenantIdTenant ID for which energy usage was calculated
Example: 64b7f1e6f9c9d4e5b8a9f7c1
daysNumber of days the energy usage was calculated over
Example: 7
startDateStart date of the energy usage period (ISO 8601 format)
Example: 2024-01-15T00:00:00.000Z
endDateEnd date of the energy usage period (ISO 8601 format)
Example: 2024-01-22T00:00:00.000Z
RoomEnergyUsageDto[] · required
List of rooms with their energy usage data
totalRoomsTotal number of rooms found for this tenant
Example: 5
totalEnergyUsageTotal energy usage across all rooms in kWh
Example: 547.32