/metrics/aggregate/buildings

Building level metrics, aggregated over the selected time period.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Example Queries

Path

/metrics/aggregate/buildings/762016?filter[date_range]=this_week&include[]=previous

Description

Retrieve aggregated metrics data for building 762016 for this week starting on Sunday, and include aggregated metrics from the previous week to compare against.

Path

/metrics/aggregate/buildings/762016?filter[local_date][gte]=2025-06-18&filter[local_date][lte]=2025-06-22

Description

Retrieve aggregated metrics data for building 762016 from June 18, 2025 to June 22, 2025.


Response


PropertyTypeDescription
avg_person_countFloatAverage number of people in the building over the selected time period.
peak_person_countIntMaximum number of people present in the building at any given time during the time period.
avg_daily_peak_person_countFloatAverage of the maximum number of people present in the building each day.
avg_capacity_usageFloatAverage percentage of the building's capacity used over the selected time period.
peak_capacity_usageFloatMaximum percentage of the building's capacity used at any given time during the selected time period.
avg_daily_peak_capacity_usageFloatAverage of the maximum percentage of the building's capacity used each day.
Path Params
integer
required

ID of the building to get metrics for

Query Params
string

Start of the time interval (interval includes this date).

string

End of the time interval (interval includes this date).

string
Defaults to previous

May optionally set this parameter to 'previous' to include comparison data from a previous time range. The previous time range will be automatically generated based on the time range selected.

string
Defaults to today

Must be one of the following: today, this_week, last_week, this_month, last_month, this_year, last_year. A request must include either this date range parameter or start and end date parameters as described above.

integer

Must be an integer within the range of 0-6. The week starts on Sunday (i.e. 0 = Sunday).

integer

Must be an integer within the range of 0-23. Defaults to working hours.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json