# EV vehicles (GET)

`GET https://bemap.benomad.com/bgis/service/evsmartrouting/vehiclemodels/list/1.0`

Part of [Electric vehicle database](https://benomad.com/dev/doc/bemap-api/electric-mobility/ev-vehicles.md).

> **List vehicle models for trip planning.** The electric vehicle models electric trip planning knows, to choose the vehicle a trip is planned for.

Returns the list of available vehicles.

Requires the EV smart routing option (Allow to compute a trip for a electric vehicle); without it BeMap answers `400 Access Denied`.

## Query parameters

- `vehicle` (string, in query)
- `brandId` (string, in query)
- `enableDatasheet` (boolean, in query)

## Response

`200`, schema `VehicleModelsResponse`.

- `vehicles` (VehicleInfo[]): A list of vehicle information.
  - `key` (string): Key of vehicle, used to select the vehicle to perform the routing calculation.
  - `brandId` (string): Brand ID of vehicle, can be used for display.
  - `brandName` (string): Brand name of vehicle, can be used for display.
  - `title` (string, deprecated): Title of vehicle, can be used for display.
  - `name` (string): Name of vehicle, can be used for display.
  - `year` (string): Year of release and end of series in format yyyy or yyyy-yyyy.
  - `variant` (string): Variant or sub name of vehicle.
  - `motorType` (enum): Motor type of vehicle.
    - `EV`: Electric Vehicle.
    - `HEV`: Hybrid Electric Vehicle.
    - `PHEV`: Plug-in Hybrid Electric Vehicle (with electric plug).
    - `NOT_SUPPORTED_VALUE`: Not supported value for this API version.
  - `batteryName` (string): The commercial name or power of vehicle battery.
  - `connectorTypes` (integer (int32)[]): List of default connector types defined by the server vehicle profile.
  - `encDatasheet` (string): Base64 encoded and encrypted JSON that contains the vehicle datasheet.
  - `chargerPowerAcSinglePhase` (number (double)): Maximum charge power (in kW) in AC 1 phase current type.
  - `chargerPowerAcThreePhases` (number (double)): Maximum charge power (in kW) in AC 3 phases current type.
  - `chargerPowerDC` (number (double)): Maximum charge power (in kW) in DC current type.

## Errors

- `400`: Bad Request
- `302`: no credentials were sent. Do not follow the redirect.
- `401`: the account or the API key is wrong.

How to read each one: [Errors](https://benomad.com/dev/doc/bemap-api/getting-started/errors.md).

## Example

```bash
curl -X GET 'https://bemap.benomad.com/bgis/service/evsmartrouting/vehiclemodels/list/1.0?brandId=5e903acb9548987051674126' \
  -u 'YOUR_ACCOUNT:YOUR_API_KEY' \
  --fail-with-body
```

Response captured from production, long arrays and strings shortened:

```json
{
  "vehicles": [
    {
      "key": "c980045d-53e1-4e30-8c0e-4557cb4f1ad5",
      "title": "Grand Kangoo E-Tech DC80kW/AC22kW (2025) 45.0kWh DC:80.0kW AC3:22.0kW",
      "connectorTypes": [
        32,
        38
      ]
    },
    {
      "key": "e7ef0b86-30f0-41bd-b9fb-15d02f9c283f",
      "title": "Kangoo e-tech AC3 22KW/DC 100KW (step 2) (2026) 52.0kWh DC:100.0kW AC3:22.0kW",
      "connectorTypes": [
        32,
        38
      ]
    }
  ]
}
```

## Reference pages

- [EV vehicles](https://benomad.com/dev/doc/bemap-api/guides/services/evsmartrouting-vehiclemodels-list.md)