---
title: "Get all alerts"
method: GET
path: "/v2/organisations/{organisation_id}/alerts"
tags: ["Gateway GRPC"]
---

# Get all alerts

`GET /v2/organisations/{organisation_id}/alerts`

## 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}/alerts`
- Auth: HTTP bearer

Get a list of alerts for the organisation

## Path parameters

- `organisation_id` string, required

## Query parameters

- `limit` number
- `page` number
- `organisations` string[]
- `alert_types` number[]
- `category` 0 | 1 | 2 | 3 | 4
- `vehicle_ids` string[]
- `has_media` boolean
- `last_n_hours` number
- `acknowledgement_filter` 1 | 2 | 3
- `alert_validity` boolean

## Response `200`

List of alerts

- GetAllAlertsResponseDto
  - `data` GetAllAlertsResponseDataDto, required
    - `items` AlertDto[], required: List of alerts
      - `id` string, required: Alert ID
      - `type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 999, required: Alert type
      - `vehicle_number` string, required: Vehicle number
      - `location` string, required: Location
      - `timestamp` string, required: Alert timestamp in milliseconds. For grouped alerts, this is end_time.
      - `start_time` string: Start of the alert interval in milliseconds
      - `end_time` string: End of the alert interval in milliseconds
      - `severity` 'low' | 'medium' | 'high' | 'critical', required
      - `organisation` OrganisationDto, required
        - `id` string, required: Organisation id
        - `display_name` string, required: Display name of the organisation
        - `parent_id` string: Effective parent organisation id when accessible to the user; omitted when the physical parent exists but is inaccessible
        - `children_count` number: Number of direct child organisations visible to the user
        - `vehicle_count` number: Total number of vehicles in this organisation and its accessible sub-organisations
        - `is_setup` boolean, required: Whether first-time setup is complete for this organisation
        - `path` OrganisationDto[]: Visible ancestor chain from top-level visible ancestor to this organisation
      - `metadata` AlertMetadataDto, required
        - `speed` number, required: Alert speed
        - `trip_id` string, uuid: Trip associated with the alert
        - `geofence_id` string, uuid: Geofence subscription associated with the alert
      - `acknowledgement` AcknowledgementDto
        - `at` string, required: Acknowledgement timestamp in milliseconds
        - `by` string, required: User ID that acknowledged alert
    - `pagination` PaginationResponseDto, required
      - `page` number, required: Current page number
      - `limit` number, required: Number of items per page
      - `total` number, required: Total number of items
      - `has_next` boolean, required: Whether there is a next page
      - `has_prev` boolean, required: Whether there is a previous page

---

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