---
title: "List alarms changed since a sequence number"
method: GET
path: "/api/v2/alarms/incremental/{sequenceNumber}"
tags: ["Alarms"]
---

# List alarms changed since a sequence number

`GET /api/v2/alarms/incremental/{sequenceNumber}`

## Request

- Base URL: `https://gear.cloud.studio`
- URL: `https://gear.cloud.studio/api/v2/alarms/incremental/{sequenceNumber}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `accessToken`

Returns alarms whose `SequenceNumber` is higher than the one sent. An
alarm gets a new sequence number when it changes, including when it is
closed. Send one, and only one, of `clientID`, `facilityID`, `deviceID`
or `endpointID`, and keep the same filter between calls.

## Path parameters

- `sequenceNumber` integer, required

## Query parameters

- `clientID` integer
- `facilityID` integer
- `deviceID` integer
- `endpointID` integer
- `maxCount` integer

## Response `200`

Alarms changed since `sequenceNumber`. An empty list means there is nothing new.

- Alarm[]
  - `AlarmID` integer
  - `DeviceID` integer
  - `EndpointID` integer
  - `AlarmTypeID` integer
  - `AlarmTypeDescription` string
  - `AlarmSeverityID` 0 | 1 | 2 | 3: 0 information, 1 low, 2 medium, 3 high.
  - `AlarmSeverityDescription` string
  - `Details` string
  - `DateTimeCreated_UTC` string
  - `DateTimeClosed_UTC` string
  - `SequenceNumber` integer

## Other responses

- `500`: The request failed. A missing, invalid or expired access token is also reported this way.

---

[API](https://skmtc.dev/cloudstudioiot/apis/cloud-studio-iot-data-extraction-api.md) · [All operations](https://skmtc.dev/cloudstudioiot/apis/cloud-studio-iot-data-extraction-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudstudioiot/apis/cloud-studio-iot-data-extraction-api/revisions/1f497bcfbbb1?raw)