---
title: "Get clustered vehicle markers for map viewport"
method: POST
path: "/v2/organisations/{organisation_id}/vehicles/in-bounds"
tags: ["Gateway GRPC"]
---

# Get clustered vehicle markers for map viewport

`POST /v2/organisations/{organisation_id}/vehicles/in-bounds`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/{organisation_id}/vehicles/in-bounds`
- Auth: HTTP bearer

## Path parameters

- `organisation_id` string, required

## Query parameters

- `entity_type` 0 | 1, required
- `state` 0 | 1 | 2 | 3 | 4

## Request body

- GetVehiclesForMapBodyDto
  - `viewport` GeofencePolygonalBoundaryDto, required
    - `vertices` string[], required: Array of coordinates defining the polygonal boundary
  - `zoom` number, required
  - `vehicle_ids` string[]: Vehicle IDs to filter by
  - `organisations` OrganisationFilterDto[]: Organisations to filter by

## Response `200`

Map markers retrieved successfully

- GetVehiclesForMapResponseDto
  - `data` GetVehiclesForMapResponseData, required
    - `items` MapMarkerDto[], required
      - `type` 'cluster' | 'vehicle', required
      - `position` GeoPointDto, required
        - `longitude` number, required: Longitude
        - `latitude` number, required: Latitude
      - `cluster` ClusterMarkerDto
        - `size` number, required
        - `stats` ClusterStatsDto
          - `moving` number, required
          - `idle` number, required
          - `stopped` number, required
          - `offline` number, required
      - `vehicle` VehicleMarkerDto
        - `vehicle_id` string, required
        - `plate_number` string, required
        - `vehicle_type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
        - `device_number` string, required
        - `status` VehicleStatusDto, required
          - `state` 0 | 1 | 2 | 3 | 4, required
          - `since` string, required
        - `location_recorded_at` string, required
        - `movement` MovementDto
          - `speed` number, required
          - `heading` number, required
          - `altitude` number
    - `total` number, required

---

[API](https://skmtc.dev/cautio/apis/cautio-api.md) - [All operations](https://skmtc.dev/cautio/apis/cautio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cautio/apis/cautio-api/revisions/214e6d1d2b6c?raw)