# Charging station charge pass

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

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

> **List charge passes.** The charge passes a driver can use at charging stations, so they can choose their own.

Returns the list of charge passes.

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)

## 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/list?providerName=ecoMovement' \
  -u 'YOUR_ACCOUNT:YOUR_API_KEY' \
  --fail-with-body
```

Response captured from production, long arrays and strings shortened:

```json
{
  "chargePasses": [
    {
      "hashId": "407273c60d13ce5952aa086db5e2542d",
      "networkName": "Berliner Stadtwerke",
      "title": "Ad hoc",
      "currency": "EUR",
      "subscriptionType": "n/a",
      "subscriptionFeeExclVat": 0
    },
    {
      "hashId": "5d2f602bcb1c27ac89e75af15ba4a2c7",
      "networkName": "Révéo",
      "title": "adhoc / non-subscribers",
      "currency": "EUR",
      "subscriptionType": "n/a",
      "subscriptionFeeExclVat": 0
    }
  ]
}
```

## Reference pages

- [Charging station charge pass](https://benomad.com/dev/doc/bemap-api/guides/services/chargingstation-chargepass.md)
- [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)