# Find vehicles (GET) · v1.1

`GET https://bemap.benomad.com/bgis/service/vehicle/1.1/findvehicles`

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

> **Search the electric vehicle database.** Electric vehicle models with their battery, their charging speed and their WLTP figures, so a driver can find their car.

Returns the list of available vehicles.

Requires the Vehicle or EV smart routing option (Allow to get the information of vehicle); without it BeMap answers `400 Access Denied`.

## Query parameters

- `vehicle` (string, in query)
- `brandId` (string, in query)
- `name` (string, in query)
- `variant` (string, in query)
- `year` (string, in query)
- `batteryName` (string, in query)
- `batteryCapacity` (string, in query)
- `motorType` (enum, in query)
  - `EV`: Electric Vehicle.
  - `HEV`: Hybrid Electric Vehicle.
  - `PHEV`: Plug-in Hybrid Electric Vehicle (with electric plug).
- `chargerPowerDC` (number (double), in query)
- `chargerPowerAC` (number (double), in query)
- `enableDatasheet` (boolean, in query)
- `lon` (number (double), in query)
- `lat` (number (double), in query)
- `countryCode` (string, in query)

## Response

`200`, schema `VehicleModelsResponseV1Dot1`.

- `vehicles` (VehicleInfoV1Dot1[]): A list of vehicle information.
  - `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.
  - `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.
  - `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.
  - `transportType` (enum): Transport type.
    - `PEDESTRIAN`: Pedestrian.
    - `BICYCLE`: Bicycle.
    - `MOTORCYCLE`: Motorcycle.
    - `CAR`: Passenger car, tourist car.
    - `TAXI`: Taxi.
    - `PUBLIC_BUS`: Public bus.
    - `EMERGENCY`: Emergency vehicle.
    - `DELIVERY_TRUCK`: Delivery truck.
    - `TRUCK`: Truck.
  - `height` (integer (int32)): Height in cm.
  - `width` (integer (int32)): Width in cm.
  - `length` (integer (int32)): Length in cm.
  - `batteryName` (string): The commercial name or power of vehicle battery.
  - `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.
  - `maxWeight` (integer (int32)): Maximum weight in tenth of ton.
  - `maxWeightPerAxle` (integer (int32)): Maximum weight per axle in tenth of ton.
  - `connectorTypes` (integer (int32)[]): List of default connector types defined by the server vehicle profile.
  - `plugAndAutoCharge` (PlugAndAutoChargeFront): Defines if the vehicle has the AutoCharge capability. AutoCharge is an EV charging technology that enables automatic authentication and initiation of a charging session by recognising a unique identifier from the EV. AutoCharge shares similarities with Plug and Charge (PnC) technology, but there are important distinctions between the two. PnC is a more comprehensive authentication standard, established by the ISO 15118 protocol.
    - `available` (boolean, required): Define if the vehicle has the capability of plug and aotomatic starting the charge. Ture if available.
    - `iso15118` (boolean): Plug & Charge: The ISO 15118 standard is supported. If Autocharge is OCPP version 2, the ISO 15118 and OCPP can be checked.
    - `ocpp` (boolean): The OCPP standard is supported. The Autocharge use OCPP version 1. If Autocharge is OCPP version 2, the ISO 15118 and OCPP can be checked.
  - `wltp` (VehicleWltp): WLTP information of vehicle.
    - `urbanWltp` (number (double)): The WLTP provided by the vehicle manufacturer for an urban cycle. Containing only the first two phases of the complete WLTP cycle.
    - `completeWltp` (number (double)): The WLTP provided by the vehicle manufacturer for a complete cycle. Containing all four phases of WLTP.
  - `consumptionInWhPerKm` (number (float)): Vehicle consumption in Wh/km.
  - `encDatasheet` (string): Base64 encoded and encrypted JSON that contains the vehicle datasheet.

## 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/vehicle/1.1/findvehicles?brandId=5e903acb9548987051674126&name=Zoe' \
  -u 'YOUR_ACCOUNT:YOUR_API_KEY' \
  --fail-with-body
```

Response captured from production, long arrays and strings shortened:

```json
{
  "vehicles": [
    {
      "motorType": "EV",
      "key": "29b8cbcd-a75e-48db-a29f-c26745013d20",
      "brandId": "5e903acb9548987051674126",
      "brandName": "Renault",
      "name": "Zoe",
      "year": "2019-2024",
      "variant": "ZE50 R135",
      "transportType": "CAR",
      "height": 156,
      "width": 179,
      "length": 409,
      "batteryName": "54.7",
      "chargerPowerAcSinglePhase": 7.33,
      "chargerPowerAcThreePhases": 22,
      "chargerPowerDC": 46,
      "maxWeight": 2,
      "maxWeightPerAxle": 0,
      "connectorTypes": [
        32,
        38
      ],
      "wltp": {
        "completeWltp": 385
      },
      "consumptionInWhPerKm": 135.06
    },
    {
      "motorType": "EV",
      "key": "44587c46-88a4-453e-9763-2cfb7a3661f4",
      "brandId": "5e903acb9548987051674126",
      "brandName": "Renault",
      "name": "Zoe",
      "year": "2017",
      "variant": "R240",
      "transportType": "CAR",
      "height": 156,
      "width": 173,
      "length": 408,
      "batteryName": "22",
      "chargerPowerAcSinglePhase": 7.33,
      "chargerPowerAcThreePhases": 22,
      "maxWeight": 2,
      "maxWeightPerAxle": 0,
      "connectorTypes": [
        32
      ]
    }
  ]
}
```

## Tutorials

- [Step-by-Step: Compute a Charging Cost from Charging Station and Tariffs data](https://benomad.com/dev/doc/bemap-api/guides/tutorials/chargingcost-from-charging-station-tariffs.md)
- [Tutorial for the first trip in electrical vehicle · 1.0](https://benomad.com/dev/doc/bemap-api/guides/tutorials/evtrip-first-trip-v1-0.md)
- [Tutorial for the first trip in electrical vehicle · 2.0](https://benomad.com/dev/doc/bemap-api/guides/tutorials/evtrip-first-trip-v2-0.md)
- [Tutorial: Truck Routing with EV Smart Routing v2.0.0](https://benomad.com/dev/doc/bemap-api/guides/tutorials/evtrip-truck.md)

## Reference pages

- [Find vehicles · v1.1](https://benomad.com/dev/doc/bemap-api/guides/services/vehicle-findvehicles-v1-1.md)