Charging stations

A charging station is one of the main entities in be.ENERGISED. The charging stations id will be used for different other calls as URL parameter (e.g. maintenance windows).

Reading

Charging stations can be accessed via the charging_stations GET endpoint. This endpoint will return a list of all visible stations in be.ENERGISED.

The list endpoint is using offset pagination.

curl --location --request GET \
'https://<slug>.beenergised.cloud/api/cpoapi/v1/charging_stations/' \
--header 'Authorization: <access_token>' \
--header 'Content-Type: application/json'

Creating

New charging stations can be created via the charging_stations POST endpoint.

curl --location --request POST \
'https://<slug>.beenergised.cloud/api/cpoapi/v1/charging_stations/' \
--header 'Authorization: <access_token>' \
--header 'Content-Type: application/json' \
--data '{
  "label": "Station A",
  "chargeBoxIdentity": "ABC123",
  "modelId": 1,
  "companyUuid": "company-uuid-here",
  "timeZone": "Europe/Berlin"
}'

Required Parameters

  • label (string): Label visible in the UI.

  • chargeBoxIdentity (string): Charge box identity used as main identifier in the OCPP connection. Must be unique.

  • modelId (integer): ID of the charging station model.

  • companyUuid (string): UUID of the company (entity) the station is connected to.

  • timeZone (string): The timezone of the station, e.g. Europe/Berlin.

Optional Parameters

  • publicDisplayName (string): Name shown in external systems like apps.

  • iccid (string): ICCID received by the station during the BootNotification.

  • imsi (string): IMSI received by the station during the BootNotification.

  • serialnumber (string): Serial number received by the station during the BootNotification.

  • address (object): Address information for the station.

  • geolocation (object): Geographic location of the station.

  • technicianUserId (integer, optional): ID of the technician to assign to this station. The technician must belong to the same company as the station. If not provided, no technician is assigned.

Assigning a Technician

To assign a technician when creating a station, first retrieve the available technicians:

curl --location --request GET \
'https://<slug>.beenergised.cloud/api/cpoapi/v1/technicians/?limit=50' \
--header 'Authorization: <access_token>' \
--header 'Content-Type: application/json'

Then use the technician’s id in the creation request:

curl --location --request POST \
'https://<slug>.beenergised.cloud/api/cpoapi/v1/charging_stations/' \
--header 'Authorization: <access_token>' \
--header 'Content-Type: application/json' \
--data '{
  "label": "Station B",
  "chargeBoxIdentity": "DEF456",
  "modelId": 1,
  "companyUuid": "company-uuid-here",
  "timeZone": "Europe/Berlin",
  "technicianUserId": 42
}'

For more information about available technicians, see the Technicians section.