---
title: "Get a geozone by ID"
method: GET
path: "/api/v2/geozones/{geozoneID}"
tags: ["Geozones"]
---

# Get a geozone by ID

`GET /api/v2/geozones/{geozoneID}`

## Request

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

## Path parameters

- `geozoneID` integer, required

## Response `200`

The geozone.

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