> For the complete documentation index, see [llms.txt](https://developers.innerspace.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.innerspace.io/api-reference-v2/zone_insights.md).

# zone\_insights

Publish Interval: Nightly

A zone, also known as a space, is a closed area on a map.

Fetch metrics at a zone level, where a metric is a measurement or insight with a single result.  Some metrics are a complex measurement or insight, possibly with multiple results.

***\<metric\_name>*** would be one or more of the metrics outlined in [Metrics and Features](/metrics-and-features.md)

```graphql
// query
query zone_insights(
  $limit: Int,
  $offset: Int,
  $order_by: [zone_metrics_order_by!],
  $where: zone_metrics_bool_exp
) {
  ZONE_INSIGHTS(
    limit: $limit,
    offset: $offset,
    order_by: $order_by,
    where: $where
  ) {
    DATE_TIME_START
    BUILDING_ID
    SITE_ID
    GRANULARITY
    ZONE_LABEL
    GROUP_ID
    <METRIC_NAME>
  }
}
```