1. consumption_report
Residentia REST API
  • Residentia REST API
    • location
      • getLocations
      • getLocationByLocationNumber
    • sensor
      • getSensorBySensorId
      • getSensorHistoryBySensorId
    • overdrive
      • setOverdriveSettings
      • getOverdriveSettings
      • getOneLocationOverdriveSettings
      • getLocationOverdriveStatus
    • consumption_report
      • getMonthlyConsumption
        GET
      • getDailyConsumption
        GET
      • getDistrictHeating
        GET
      • specificEnergyConsumption
        GET
    • heating
      • getLocationHeatingCurve
      • getLocationTargetSetpoint
    • Schemas
      • LocationItem
      • LocationSensorItem
      • SensorItem
      • SensorHistoryItem
      • HistoryData
      • OverdriveBody
      • Overdrive
      • OverdrivePostResponse
      • OverdriveGetResponse
      • HeatingCurvePoint
      • HeatingCurveItem
      • TargetSetpointItem
      • OverdriveStatusItem
      • MonthlyConsumptionItem
      • SpecificEnergyTypeResult
  1. consumption_report

getDailyConsumption

GET
/location/{location_number}/daily_consumption
Get daily consumption data for a specific location number between the given start and end dates (YYYY-MM-DD format).
You must specify one of the available types: district_heating, water, or electricity.

Request

Authorization
API Key
Add parameter in header
X-ApiKey
Example:
X-ApiKey: ********************
or
Path Params

Query Params

Responses

🟢200
application/json
List of daily consumption items. Item shape varies by type:
district_heating: sensor_id, date, consumption, unit: mwh.
electricity: sensor_id, date, totalConsumption, unit: kwh.
water: date, totalConsumption, unit: l. No sensor_id (aggregated across sensors).
Bodyapplication/json

🟠400
🟠403
🟠404
🟠429
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/location/10000001/daily_consumption?startDate=undefined&endDate=undefined&type=undefined' \
--header 'X-ApiKey: <api-key>'
Response Response Example
200 - Example 1
[
    {
        "sensor_id": "string",
        "date": "2019-08-24",
        "consumption": 0,
        "totalConsumption": 0,
        "unit": "mwh"
    }
]
Modified at 2026-06-18 14:38:42
Previous
getMonthlyConsumption
Next
getDistrictHeating
Built with