# Find vehicles · v1.0

REST API, Service version 1.0.0

> API reference: [`GET /vehicle/1.0/findvehicles`](https://benomad.com/dev/doc/bemap-api/api/electric-mobility/vehicle-findvehicles-v1-0-get.md), [`POST /vehicle/1.0/findvehicles`](https://benomad.com/dev/doc/bemap-api/api/electric-mobility/vehicle-findvehicles-v1-0-post.md)

To retrieve vehicles or vehicle information.

## Find vehicles

Returns the list of available vehicles.
HTTP method `GET` or `POST`. 
URI: `/bgis/service/vehicle/1.0/findvehicles`

Parameters:

- `vehicle` (string): Vehicle id (uuid key).
- `brandId` (string): EV vehicle brand ID.
- `name` (string): Vehicle model name.
- `batteryName` (string): Battery name.
- `batteryCapacity` (string, deprecated): Battery capacity.
- `year` (string): Year of release and end of series in format yyyy or yyyy-yyyy.
- `motorType` (enum): Define the type of motor (engine), is an electric or PHEV motor.
  - `EV`: Electric Vehicle.
  - `HEV`: Hybrid Electric Vehicle.
  - `PHEV`: Plug-in Hybrid Electric Vehicle (with electric plug).
- `chargerPowerDC` (number (double)): DC Power in kW of vehicle charger.
- `chargerPowerAC` (number (double)): AC Power in kW of vehicle charger.
- `enableDatasheet` (boolean): Enable the returned datasheet of vehicle. See field encDatasheet.
- `coordinate` (Coordinate): WGS84 coordinate. Used to filter vehicle data such as available connectors in this country.
  - `lon` (number (double), required): Longitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `longitude`.
  - `lat` (number (double), required): Latitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `latitude`.
- `countryCode` (string): ISO-3 country code. Used to filter vehicle data such as available connectors in this country.

## Response

### Details of fields

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

<div>
<h5><strong>VehicleDatasheet</strong></h5>

The fields are listed with the operation: [Find vehicles (GET) · v1.0](https://benomad.com/dev/doc/bemap-api/api/electric-mobility/vehicle-findvehicles-v1-0-get.md), [Find vehicles (POST) · v1.0](https://benomad.com/dev/doc/bemap-api/api/electric-mobility/vehicle-findvehicles-v1-0-post.md).

</div>

### Response samples

JSON Sample:
```javascript
{
    "vehicles": [
        {
            "key": "8724c12d-1ec8-426f-af2a-84ac1a030001",
            "brandId": "609a4642c9cb5b0b1846c129",
            "brandName": "Fiat",
            "name": "500e",
            "year": "2020",
            "variant": "Action, Action plus",
            "motorType": "EV",
            "batteryName": "24",
            "connectorTypes": [
                32,
                38,
                48
            ],
            "chargerPowerAcSinglePhase": 7.0,
            "chargerPowerAcThreePhases": 11.0,
            "chargerPowerDC": 50.0
        },
        {
            "key": "b8527b78-6240-4a32-8d23-66ccbdd10def",
            "brandId": "609a4642c9cb5b0b1846c129",
            "brandName": "Fiat",
            "name": "500e",
            "year": "2020",
            "variant": "Icône, Icône plus, La prima",
            "motorType": "EV",
            "batteryName": "42",
            "connectorTypes": [
                32,
                38,
                48
            ],
            "chargerPowerAcSinglePhase": 7.0,
            "chargerPowerAcThreePhases": 11.0,
            "chargerPowerDC": 85.0
        },
        {
            "key": "444720e1-4591-42e2-bec2-b6f5d3351909",
            "brandId": "609a4642c9cb5b0b1846c129",
            "brandName": "Fiat",
            "name": "500e US",
            "year": "2013",
            "motorType": "EV",
            "batteryName": "24",
            "connectorTypes": [
                31
            ],
            "chargerPowerAcSinglePhase": 6.6
        },
        {
            "key": "4d7be666-6f01-4fe8-bb92-e478beb0e5f3",
            "brandId": "609a4642c9cb5b0b1846c129",
            "brandName": "Fiat",
            "name": "e-Ducato",
            "motorType": "EV",
            "batteryName": "47",
            "connectorTypes": [
                32,
                38,
                48
            ],
            "chargerPowerAcSinglePhase": 7.0,
            "chargerPowerDC": 50.0
        }
    ]
}
```