---
title: "List endpoint data recorded since a sequence number"
method: GET
path: "/api/v2/endpointData/incremental/{sequenceNumber}"
tags: ["Endpoint data"]
---

# List endpoint data recorded since a sequence number

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

## Request

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

Returns readings whose `SequenceNumber` is higher than the one sent.
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`

Readings recorded since `sequenceNumber`. An empty list means there is nothing new.

- EndpointData[]
  - `EndpointID` integer
  - `Timestamp_UTC` string
  - `Value` number, double: Numeric value. Scalar endpoints and IAS zones.
  - `IsOn` boolean: Appliances and dimmers.
  - `IsMoving` boolean: Closures.
  - `DimLevel` integer: Dimmers.
  - `Position` integer: Closure controllers.
  - `ActiveEnergy` number, double: Power meters.
  - `ReactiveEnergy` number, double: Power meters.
  - `ApparentEnergy` number, double: Power meters.
  - `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)