---
title: "Get Sensor Alerts"
method: GET
path: "/environment/v1/alerts"
tags: ["Alerts"]
---

# Get Sensor Alerts

`GET /environment/v1/alerts`

## Request

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

Returns all alerts for all (or subset of) sensors in an org over a specified time range.

The response will include a list of sensor alerts for the organization (or given devices), including the device that triggered the alert, the alert threshold, and start and end timestamp of the alert.

## Query parameters

- `device_ids` string, required: A comma separated list of sensor IDs.
- `start_time` integer: The start of the time range for requested alerts. Formatted as a Unix timestamp in seconds. Default value is an hour from the current time.
- `end_time` integer: The end of the time range for requested alerts. Formatted in Unix timestamp in seconds. Default value is the current time.
- `page_size` integer: The number of items returned in a single response. Default is 100. Max is 200.
- `page_token` string: The pagination token used to fetch the next page of results.
- `fields` string: Retrieves alerts only for the given fields. Fields must be 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 left blank, alerts of all sensor types will be returned in the response.

## Response `200`

OK

- SensorAlertsResponseV1: Sensor Alerts Response schema
  - `alert_events` SensorAlert[]: A list of sensor alert events.
    - `alert_event_id` string, uuid: The unique identifier for the triggered alert.
    - `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.
    - `end_time` integer: The end time of the alert. Formatted in Unix epoch format.
    - `is_above_max_event` boolean: If the alert can be configured with a low and a high threshold, this value will be <code>true</code> if the value that triggered the alert was above the high threshold. This only applies to temperature and humidity alerts.
    - `most_extreme_value` number: The most extreme value for the sensor that was detected during the alert window.
    - `reading` string: The sensor type of the alert.
    - `start_time` integer: The start time of the alert. Formatted in Unix epoch format.
    - `threshold` number: The user-defined threshold of the alert.
  - `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)