---
title: "Get Dashboard Occupancy Trend Data"
method: GET
path: "/cameras/v1/analytics/dashboard_occupancy_trends"
tags: ["Analytics"]
---

# Get Dashboard Occupancy Trend Data

`GET /cameras/v1/analytics/dashboard_occupancy_trends`

## Request

- Base URL: `https://api.verkada.com`
- URL: `https://api.verkada.com/cameras/v1/analytics/dashboard_occupancy_trends`
- Auth: one of:
  - API key in header `x-verkada-auth`
  - API key in header `x-api-key`

Returns all occupancy trends data for a particular dashboard over a specified time range.

Responses will include the start and end time of the data requested and org, dashboard information (ID, name) alongside the readings.

## Query parameters

- `dashboard_id` string, required: The unique identifier of the dashboard.
- `start_time` integer: The start of the time range for dashboard occupancy trends. Formatted as a Unix timestamp in seconds. Defaults to an hour from the current time.
- `end_time` integer: The end of the time range for dashboard occupancy trends. Formatted as a Unix timestamp in seconds. Defaults to the current time.
- `interval` '15_minutes' | '1_hour' | '1_day': An enumeration.

## Response `200`

OK

- DashboardOccupancyTrendsResponseV1
  - `dashboard_id` string, required: The unique identifier of the dashboard.
  - `dashboard_name` string, required: The name of the dashboard.
  - `end_time` integer, required: The end of the time range for occupancy trends.
  - `occupancy` array[], required: An array with range timestamps, and net occupancy.
    - integer[]
  - `org_id` string, required: The unique identifier of the organization.
  - `org_name` string, required: The name of the organization.
  - `start_time` integer, required: The start of the time range of occupancy trends.
  - `trend_in` array[], required: An array with range timestamps, and count for “in” direction.
    - integer[]
  - `trend_out` array[], required: An array with range timestamps, and count for “out” direction.
    - integer[]

---

[API](https://skmtc.dev/verkada/apis/camera-api.md) - [All operations](https://skmtc.dev/verkada/apis/camera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verkada/apis/camera-api/revisions/26cbfa5870e4?raw)