Skip to main content

New Bulk Space Aggregated Metrics Endpoint

· One min read
Thomas Scott
Thomas Scott
Software Engineer

We've just released a new bulk space aggregated metrics endpoint, allowing you to retrieve aggregated metrics for up to 40 spaces in a single request.

This complements the existing single-space endpoint and follows the same bulk pattern as the bulk device consumption endpoint released earlier.

What You Can Do​

With the bulk space aggregated metrics endpoint, you can retrieve aggregated time series data for multiple spaces at once, with configurable granularity.

Supported metric types:

  • Electricity
  • Heating
  • Water
  • Gas
  • Cooling
  • Temperature
  • CO2
  • Humidity
  • Occupancy

Supported granularities:

  • Hourly (temperature, CO2, and humidity only)
  • Daily
  • Weekly
  • Monthly

The response includes summary statistics (total, minimum, maximum, average) alongside the time series data for each space. If a space belongs to a cluster, utility metrics reflect cluster-wide consumption.

Any spaces that cannot be found are returned in the errors array, so you can handle partial failures gracefully.

Support​

Need help? Reach out anytime via support@utopi.co.uk - we're here to support you with your integration.

What's Next​

Keep an eye out for new features and updates as we continue to develop the API further!