/metrics/aggregate/spaces

Metrics for all spaces in a building, or company

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

Example Queries

Path

/metrics/aggregate/spaces?filter[local_date][gte]=2022-08-02&filter[local_date][lte]=2022-08-20&&filter[building_id]=654321

Description

Retrieve aggregated metrics for all spaces contained in building 654321 for the period where local_date is greater than 2022-08-02 and local_date is less than 2022-08-20.

Response

PropertyTypeDescription
avg_person_countIntAverage number of people in the space over the selected time period.
avg_person_count_when_usedIntAverage number of people in the space, but only considering times when it was in use.
peak_person_countIntMaximum number of people present in the space at any given time during the time period.
avg_daily_peak_person_countIntAverage of the highest number of people present in the space each day.
active_minutes_usedIntTotal minutes the space was actively occupied (e.g., when people were engaged in a primary activity).
passive_minutes_usedIntTotal minutes the space was passively occupied (e.g., when people were present but not actively using it).
total_hours_actively_occupiedIntTotal hours the space was actively used during the time period.
pct_active_timeIntPercentage of total available time the space was actively in use.
pct_passive_timeIntPercentage of total available time the space was passively occupied.
avg_capacity_usageIntAverage percentage of the space’s capacity used over the time period.
avg_capacity_usage_when_usedIntAverage percentage of the space’s capacity used, only considering times when it was occupied.
Query Params
date-time
Defaults to 2025-05-05

Timestamp (UTC) that you would like the results to be greater than or equal to.

date-time
Defaults to 2025-05-06

Timestamp (UTC) that you would like the results to be less than or equal to.

int32

Filter metrics based on one building.

filter[hours_of_day]
array of int32s

Hours of the day to include in metrics. Example: [0, 5, 6, 13]

filter[hours_of_day]
string

Days of the week to include in metrics. Example: [0, 1, 2]

int32

Page number for pagination.

int32

Page size for pagination.

include[]
array of strings

Joined data to include with your metrics. Options: 'space', 'space_type', and 'space_groups'

include[]
Responses

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