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

---

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