---
title: "List EV models supported by the route planner"
method: GET
path: "/ev-vehicles"
tags: ["EV Routing"]
---

# List EV models supported by the route planner

`GET /ev-vehicles`

The electric vehicles the route planner can plan for, with usable battery, rated consumption, DC ports and peak charging power. Use an id from here as the vehicleId parameter of GET /v1/ev-route. Unfiltered, this returns the whole catalog in one response.

## Query parameters

- `brand` string
- `q` string

## Response `200`

Matching vehicles, plus the attribution required by the catalog license.

- EvVehiclesResponse
  - `attribution` string — Required credit for the vehicle catalog — a license condition, display it alongside the data
  - `count` integer
  - `vehicles` object[]
    - `id` string
    - `brand` string
    - `model` string
    - `variant` string, nullable
    - `releaseYear` integer, nullable
    - `usableBatteryKwh` number
    - `consumptionWhPerKm` number
    - `dcMaxKw` number
    - `dcPorts` string[]

## Other responses

- `400` — Invalid query parameter
- `403` — Invalid or missing API key, suspended account, or inactive subscription
- `429` — Monthly quota exhausted or per-minute rate limit exceeded. Quota responses carry resetDate; rate-limit responses carry a Retry-After header.
- `502` — Upstream vehicle catalog unavailable

## Changes

- **2026-08-10** `cf1d4e12baca` — 9 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`
  - removed the non-success response with the status `401`
  - added the optional property `code` to the response with the `400` status
  - …5 more

[Change history](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api/changes/ev-vehicles/get.md)

---

[API](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api.md) · [All operations](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/carapi/carapi-dev-automotive-data-api/revisions/cf1d4e12baca/schema)