---
title: "Get Vehicle Alerts"
method: GET
path: "/v1/vehicles/{vehicle_id}/alerts"
tags: ["Vehicle Alerts"]
---

# Get Vehicle Alerts

`GET /v1/vehicles/{vehicle_id}/alerts`

Retrieve alerts for a vehicle based on its unique ID.


Possible Codes in Error Response (see [Errors](https://docs.volteras.com/api-reference/errors) for error response schema and meaning of codes):

- AUTHENTICATION_ERROR
- PAGE_SIZE_TOO_LARGE
- PAGINATED_QUERY_FILTER_CHANGED
- REQUEST_VALIDATION_ERROR
- RESOURCE_NOT_FOUND
- SERVER_ERROR

## Path parameters

- `vehicle_id` string, required — Unique internal identifier for the vehicle.

## Query parameters

- `maxPageSize` integer — Max size of the returned list.
- `pageToken` string, nullable — Page token used for pagination.
- `filter` string, nullable — Listing filter schema.

## Response `200`

Successful Response

- PageVehicleAlertResponse
  - `results` VehicleAlertResponse[], required — Returned data from the listing query.
    - `id` string, required
    - `status` 'ACTIVE' | 'RESOLVED', required
    - `alertDefinitionId` string, required
    - `vehicleId` string, required
    - `muted` boolean, required
    - `createdAt` string, date-time, required
    - `currentSeverity` 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL', required
    - `vin` string, nullable
    - `resolutions` AlertResolutionInstanceSchema[], required
      - `id` string, required
      - `definition` AlertResolutionDefinition, required
        - `id` string, required
        - `name` string, required
        - `description` string, required
      - `status` 'PENDING' | 'COMPLETED', required
      - `steps` AlertStepInstance[], required
        - `id` string, required
        - `status` 'PENDING' | 'COMPLETED', required
        - `definition` AlertStepDefinition, required
          - `id` string, required
          - `description` string, required
          - `order` integer, required
    - `definition` AlertDefinitionBase, required
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `message` string, required
      - `category` AlertCategory, required
        - `id` string, required
        - `name` string, required
        - `description` string, nullable, required
    - `metadata` AlertMetadata, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `triggerName` string, nullable
    - `triggerDescription` string, nullable
  - `nextPageToken` string, nullable, required — Next page token used for pagination.
  - `totalResults` integer, required — Total result count.

---

[API](https://skmtc.net/volteras/apis/volteras-connect.md) · [All operations](https://skmtc.net/volteras/apis/volteras-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/volteras/volteras-connect/revisions/bcb08bba814d/schema)