# Charging station charge pass autocomplete suggestions

`GET https://bemap.benomad.com/bgis/service/chargingstation/chargepass/1.0/autocomplete`

Part of [Charging stations](https://benomad.com/dev/doc/bemap-api/electric-mobility/charging-stations.md).

> **Suggest charge passes as the user types.** The charge passes whose name matches what the user types, for a search field.

Returns the list of charge passes matching the input.

Requires the Charging station search or EV smart routing option (Allow to get the charging station information); without it BeMap answers `400 Access Denied`.

## Query parameters

- `geoServer` (string, in query)
- `providerName` (string, required, in query)
- `input` (string, required, in query)

## Response

`200`, schema `ChargingStationChargePassResponse`.

- `chargePasses` (ChargingTariffChargePassFront[]): List of charge pass.
  - `hashId` (string, required): Unique identifier of charge pass.
  - `title` (string, required): Name of charge pass.
  - `networkName` (string): Unique name of charge network.
  - `description` (string): A brief description or summary of the station charge pass.
  - `currency` (string): Currency used for the subscription fee. This field stores the currency code or symbol used for the subscription fee.
  - `subscriptionType` (string): Type of subscription associated with the entity. This may denote the specific subscription model or tier for accessing the station service.
  - `subscriptionFeeExclVat` (number (float)): Subscription fee excluding VAT. This field stores the fee amount charged for a subscription before any value-added tax is applied.
  - `networkUrl` (string): URL link to the website of charge network.
  - `androidAppUrl` (string): URL link to the Android application of charge network.
  - `iosAppUrl` (string): URL link to the iOS application of charge network.

## 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/chargingstation/chargepass/1.0/autocomplete?providerName=ecoMovement&input=Ionity' \
  -u 'YOUR_ACCOUNT:YOUR_API_KEY' \
  --fail-with-body
```

Response captured from production, long arrays and strings shortened:

```json
{
  "chargePasses": [
    {
      "hashId": "2f0581a4648e0889b77321d14d2d7c36",
      "networkName": "IONITY",
      "title": "Ionity Direct",
      "description": "Adhoc payment",
      "currency": "EUR",
      "subscriptionType": "n/a",
      "subscriptionFeeExclVat": 0
    },
    {
      "hashId": "768aa96890040e7bb7677de03bdcabe4",
      "networkName": "AMB",
      "title": "Charging Points of AMB",
      "currency": "EUR",
      "subscriptionType": "n/a",
      "subscriptionFeeExclVat": 0
    }
  ]
}
```

## Reference pages

- [Charging station filter v2](https://benomad.com/dev/doc/bemap-api/guides/reference/chargingstation-filter-v2.md)
- [Charging station filter v1](https://benomad.com/dev/doc/bemap-api/guides/reference/chargingstation-filter-v1.md)