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

# List geozones changed since a sequence number

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

## Request

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

Returns geozones whose configuration changed, deleted ones included
(`Enabled: false`). The sequence number does not change when a vehicle
enters or leaves a geozone, so this method cannot track those events.

## Path parameters

- `sequenceNumber` integer, required

## Query parameters

- `clientID` integer, required
- `maxCount` integer

## Response `200`

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

- Geozone[]
  - `GeozoneID` integer
  - `ClientID` integer
  - `Description` string
  - `ExternalCode` string
  - `Polygon` object
    - `PolygonID` integer
    - `Points` array[]: Coordinates, each as latitude and longitude.
      - number[]
    - `BorderColor` integer: 24-bit RGB.
    - `BorderWidth` integer: Pixels.
    - `BorderOpacity` number
    - `FillColor` integer: 24-bit RGB.
    - `FillOpacity` number
  - `Vehicles` object[]: Vehicles currently inside the geozone.
    - `VehicleID` integer
    - `Description` string
    - `LicensePlate` string
  - `SequenceNumber` integer
  - `Enabled` boolean: False when the geozone was deleted. Deleted geozones only appear in the incremental list.

## 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)