# Connector list of charging station

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

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

> **List connector types.** Every type of connector the charging stations offer, so a driver can say which ones their vehicle takes.

Returns the list of connector type used by charging station (EVSE).

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

- `deprecatedConnector` (boolean, in query)

## Response

`200`, schema `ConnectorTypeResponse`.

- `types` (ConnectorTypeFront[]): Types.
  - `id` (integer (int32)): BeMap unique identifier of connector.
  - `key` (string): BeMap unique identifier text key of connector. Same as id field but with string value.
  - `operatorId` (string): Operator unique identifier like eMI3 format.
  - `deprecated` (boolean): Set to true if the information is deprecated.
  - `name` (string): Name of connector.
  - `norm` (string): Norm of connector.
  - `maxPower` (number (double)): Maximal power in kW of connector. Unlimited is `0`.
  - `power` (number (double)): Available power in kW can be delivered by the station or charge point.
  - `voltage` (number (float)): Voltage of current.
  - `ampere` (number (float)): Ampere of current.
  - `acSingle` (boolean): AC single phase.
  - `acThree` (boolean): Current type AC three phases.
  - `dc` (boolean): Current type DC.
  - `cable` (boolean): The connector have a cable.

## 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/connector/list/1.0?deprecatedConnector=false' \
  -u 'YOUR_ACCOUNT:YOUR_API_KEY' \
  --fail-with-body
```

Response captured from production, long arrays and strings shortened:

```json
{
  "types": [
    {
      "id": 30,
      "key": "UNDEFINED",
      "deprecated": false,
      "name": "Undefined",
      "norm": "",
      "maxPower": 0,
      "acSingle": false,
      "acThree": false,
      "dc": false,
      "cable": false
    },
    {
      "id": 31,
      "key": "TYPE_1-ATTACHED_CABLE",
      "deprecated": false,
      "name": "Type 1",
      "norm": "IEC 62196 Type 1 (SAE J1772)",
      "maxPower": 7.4,
      "acSingle": true,
      "acThree": false,
      "dc": false,
      "cable": true
    }
  ]
}
```

## Tutorials

- [Charging Station Parameters: Detailed Usage Guide](https://benomad.com/dev/doc/bemap-api/guides/tutorials/chargingstation-parameters.md)
- [Charging Station Options: Usage Guide](https://benomad.com/dev/doc/bemap-api/guides/tutorials/chargingstation-options.md)
- [Condition: Detailed Usage Tutorial](https://benomad.com/dev/doc/bemap-api/guides/tutorials/evtrip-conditions.md)

## Reference pages

- [Connector list of charging station](https://benomad.com/dev/doc/bemap-api/guides/services/chargingstation-connector.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)