---
title: "Get Sensor Data"
method: GET
path: "/environment/v1/data"
tags: ["Data"]
---

# Get Sensor Data

`GET /environment/v1/data`

## Request

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

Returns all sensor readings for a particular sensor over a specified time range.

Responses will include the start and end time of the data requested and device information (ID, serial number) alongside the readings.

## Query parameters

- `device_id` string, required: The unique identifier of the device.
- `start_time` integer: The start of the time range for requested sensor data. 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 requested sensor data. Formatted as a Unix timestamp in seconds. Defaults to the current time.
- `page_token` string: The pagination token used to fetch the next page of results.
- `page_size` integer: The number of items returned in a single response. Default is 100. Max is 200.
- `fields` string: One or multiple comma separated values from <code>humidity</code>, <code>motion</code>, <code>noise_level</code>, <code>pm_2_5</code>, <code>pm_4_0</code>, <code>pm_1_0_0</code>, <code>tamper</code>, <code>temperature</code>, <code>tvoc</code>(SV11), <code>usa_air_quality_index</code>, <code>vape_index</code>, <code>carbon_dioxide</code>, <code>carbon_monoxide</code>, <code>barometric_pressure</code>, <code>formaldehyde</code>, <code>ambient_light</code>, <code>tvoc_index</code>(SV23/SV25), <code>heat_index</code>. If blank, all sensor readings will be returned in the response.
- `interval` string: The time interval for the requested sensor data. Data is stored with 1 second intervals for 30 days, and with 5 minute intervals for data between 30 days and 365 days old. A valid value for this field is a number followed by a supported format. Supported formats are <code>s</code>, <code>m</code>, and <code>h</code> for seconds, minutes, and hours, respectively. For example, `5m` would specify a 5 minutes interval for the data. If left blank, a default resolution will be calculated based on time range.

## Response `200`

OK

- SensorDataResponseV1
  - `data` object[]
  - `device_id` string, uuid: The unique identifier of the device.
  - `device_name` string: The name of the device.
  - `device_serial` string: The serial number of the device.
  - `interval` string: The time interval of the requested sensor data.
  - `next_page_token` string: The pagination token used to fetch the next page of results.

---

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