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

# Get Vehicle Alerts

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

## Request

- Base URL: `https://api.volteras.com`
- URL: `https://api.volteras.com/v1/vehicles/{vehicle_id}/alerts`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/v1/oauth2/token`
- TypeScript: <https://skmtc.dev/volteras/apis/volteras-connect/docs/v1/vehicles/:vehicle_id/alerts/get.ts> (a function with typed inputs; its response is checked against the schema)

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
        - `code` 'SIGNAL_LOSS' | 'CONNECTIVITY' | 'TIRE_PRESSURE' | 'VEHICLE_INFO' | 'SERVICE_SCHEDULE' | 'ACCIDENT' | 'BATTERY_12V' | 'LOCATION' | 'WARRANTY_CONDITIONS' | 'LEASE_TERMS'
    - `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.

## Changes

- **2026-09-15** `3c3ea20306d1`: 1 info
  - added the optional property `results/items/definition/category/code` to the response with the `200` status

[Operation history](https://skmtc.dev/volteras/apis/volteras-connect/changes/v1/vehicles/:vehicle_id/alerts/get.md)

---

[API](https://skmtc.dev/volteras/apis/volteras-connect.md) - [All operations](https://skmtc.dev/volteras/apis/volteras-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/volteras/apis/volteras-connect/revisions/efc902486155?raw)