# Find vehicles (GET) · v1.0

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

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

**Deprecated.**

A newer version replaces it: [Find vehicles (GET) · v1.1](https://benomad.com/dev/doc/bemap-api/api/electric-mobility/vehicle-findvehicles-v1-1-get.md).

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)
- `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 `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/vehicle/1.0/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": [
    {
      "key": "29b8cbcd-a75e-48db-a29f-c26745013d20",
      "brandId": "5e903acb9548987051674126",
      "brandName": "Renault",
      "name": "Zoe",
      "year": "2019-2024",
      "variant": "ZE50 R135",
      "motorType": "EV",
      "batteryName": "54.7",
      "connectorTypes": [
        32,
        38
      ],
      "chargerPowerAcSinglePhase": 7.33,
      "chargerPowerAcThreePhases": 22,
      "chargerPowerDC": 46
    },
    {
      "key": "44587c46-88a4-453e-9763-2cfb7a3661f4",
      "brandId": "5e903acb9548987051674126",
      "brandName": "Renault",
      "name": "Zoe",
      "year": "2017",
      "variant": "R240",
      "motorType": "EV",
      "batteryName": "22",
      "connectorTypes": [
        32
      ],
      "chargerPowerAcSinglePhase": 7.33,
      "chargerPowerAcThreePhases": 22
    }
  ]
}
```

## Reference pages

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