specificEnergyConsumption

Developing

GET

https://residentia.fi/api/v1/location/{locationId}/specific_energy_consumption

Retrieves the specific energy consumption data for a given location and year, filtered by type of consumption data.

Request

Authorization

API Key

Add parameter in header

X-ApiKey

Example:

X-ApiKey: ********************

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://residentia.fi/api/v1/location/123/specific_energy_consumption?year=2024&type=district_heating' \
--header 'X-ApiKey: <api-key>'

Responses

🟢200Success

application/json

Body

Example

{
    "district_heating": {
        "location_number": "156",
        "year": "2024",
        "type": "district_heating",
        "specificConsumption": 39.3346,
        "unit": "kWh/m3",
        "dataCompleteness": "full",
        "dataRange": {
            "start": "2024-01",
            "end": "2024-12"
        }
    },
    "water": {
        "location_number": "156",
        "year": "2024",
        "type": "water",
        "specificConsumption": 117.5956,
        "unit": "liters/occupant/day",
        "dataCompleteness": "full",
        "dataRange": {
            "start": "2024-01",
            "end": "2024-12"
        }
    },
    "electricity": {
        "location_number": "156",
        "year": "2024",
        "type": "electricity",
        "specificConsumption": 4.9065,
        "unit": "kWh/m3",
        "dataCompleteness": "full",
        "dataRange": {
            "start": "2024-01",
            "end": "2024-12"
        }
    }
}

🟠400Bad Request

🟠404Record Not Found

🟠429429

🔴500Server Error

Modified at 2025-10-22 11:05:22

getDistrictHeating

LocationItem