GET /api/external/v3/statistics/space/level/{ordinal}/{start}/{end}/energy-usage

Get monthly statistics data for a space level in the structure, between start and end date, grouped by usage type.

Request Information

Permissions

The user must be authorized and must have at least one of these operations to access this api method.

Operation (significant name)	Description
Access external API (acc_extapi)	Gives the user access to the external API.

Embeded Resource Parameters

None

URI Parameters

Name	Description	Type	Additional information
ordinal	Ordinal of the desired level.	integer	Required
start	Start date for the period to get statistics for. Maximum period length is 5 years.	date	Required
end	End date for the period to get statistics for. Maximum period length is 5 years.	date	Required

Body Parameters

None.

Response Information

Resource Description

A list with energy data if any, otherwise an empty list.

DataResultOfSpaceStatsEnergyUsageDto

Name	Type	Additional information
Data	Collection of SpaceStatsEnergyUsageDto	None.
Total	integer	None.
Take	integer	None.
Skip	integer	None.

Response Formats

application/json, text/json

Sample:

{
  "data": [
    {
      "usageType": "sample string 1",
      "usageClass": "sample string 2",
      "spaceId": 3,
      "spaceNo": "sample string 4",
      "spaceName": "sample string 5",
      "spaceSynchronizationKey": "sample string 6",
      "date": "2025-04-26T14:17:55.9138989+02:00",
      "energyUnit": "sample string 8",
      "energy": 1.1,
      "energyNormalized": 1.1,
      "energyClimateNeutral": 1.1,
      "costTotal": 1.0,
      "costFixed": 1.0,
      "costCons": 1.0,
      "costDeb1": 1.0,
      "costDeb2": 1.0,
      "cO2": 1.1,
      "lastUpdated": "2025-04-26T14:17:55.9138989+02:00"
    },
    {
      "usageType": "sample string 1",
      "usageClass": "sample string 2",
      "spaceId": 3,
      "spaceNo": "sample string 4",
      "spaceName": "sample string 5",
      "spaceSynchronizationKey": "sample string 6",
      "date": "2025-04-26T14:17:55.9138989+02:00",
      "energyUnit": "sample string 8",
      "energy": 1.1,
      "energyNormalized": 1.1,
      "energyClimateNeutral": 1.1,
      "costTotal": 1.0,
      "costFixed": 1.0,
      "costCons": 1.0,
      "costDeb1": 1.0,
      "costDeb2": 1.0,
      "cO2": 1.1,
      "lastUpdated": "2025-04-26T14:17:55.9138989+02:00"
    }
  ],
  "total": 1,
  "take": 2,
  "skip": 3
}