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

# Get Sensor Alerts

`GET /environment/v1/alerts`

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.net/verkada/apis/api-tokens.md) · [All operations](https://skmtc.net/verkada/apis/api-tokens/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verkada/api-tokens/revisions/4a79d2d949a6/schema)