Skip to main content
PUT
Stations / Update

Authorizations

Authorization
string
header
required

OAuth2 Bearer Authorization

Scopes

asset:stations

Headers

Accept-Language
string

BCP 47 language tag for content negotiation (e.g. en, de-DE).

Example:

"en"

Path Parameters

uuid
string
required

UUID of the Station

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$

Body

application/json

Updates a station. Required permission: asset:stations:update. Available contexts: API Key, User.

controller_uuid
string
required

The UUID of the controller managing this station. Links the station to the hardware device responsible for OCPP communication with the backend.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
export
boolean
default:true

Whether the station is included in interface outputs such as the Whitelabel app and POI data (e.g. Google Maps). Set to false to hide it from all public-facing outputs. Defaults to true.

evse
string

Evses of the chargepoints

charging_technology
enum<string>

Charging technology. Allowed values: conductive (cable-based), inductive (wireless). If it is missing or null, the stored value stays unchanged.

Available options:
inductive,
conductive
position
string

Physical position on the site (e.g. "Parking deck level 2, bay 14").

Maximum string length: 100
Example:

"parking bay 3"

vehicle_type
enum<string>

Primary vehicle category. Allowed values: ruralenergy (shore power), omnibus (buses), four_wheeled (cars), two_wheeled (motorcycles, e-bikes). If it is missing or null, the stored value stays unchanged.

Available options:
ruralenergy,
omnibus,
four_wheeled,
two_wheeled
Example:

"four_wheeled"

status
enum<string>

Current lifecycle state of the station. Allowed values: in_planning, under_construction, factory_acceptance_test, demo, active (in operation), defect, out_of_order, removed (decommissioned), undefined. If it is missing or null, the stored value stays unchanged.

Available options:
in_planning,
under_construction,
factory_acceptance_test,
demo,
active,
defect,
out_of_order,
removed,
undefined
start_date
string<date>

Planned start or project kick-off date for the station, used for internal planning and project tracking.

Pattern: ^\d{4}-\d{2}-\d{2}$
target_date
string<date>

Target commissioning date by which the station should be operational, used for installation scheduling.

Pattern: ^\d{4}-\d{2}-\d{2}$
active_date
string<date>

Date the station was officially put into operation. Relevant for billing, reporting, and lifecycle tracking.

Pattern: ^\d{4}-\d{2}-\d{2}$
out_of_order_date
string<date>

Date the station was taken out of order.

Pattern: ^\d{4}-\d{2}-\d{2}$
ip_protection_type
string

IP rating of the enclosure (e.g. "IP54", "IP65"), indicating resistance to dust and water ingress.

Maximum string length: 5
particularities
string

Remarks about hardware specifics or installation peculiarities.

Maximum string length: 64
manufacturer
string

Hardware manufacturer (e.g. ABB, Mennekes, Compleo).

Maximum string length: 100
model
string

Hardware model name.

Maximum string length: 100
green_power
boolean
default:false

Whether the station is supplied with certified green electricity. Transmitted to roaming partners and may be shown in the app.

vehicle_communication_type_id
integer<int32>

Identifies the vehicle-to-station communication standard (e.g. ISO 15118, IEC 61851), used for advanced features such as Plug & Charge.

serial_number
integer<int32>

Manufacturer-assigned serial number.

mounting_type
enum<string>

Physical mounting style. Allowed values: free_standing (pole/pillar), wall (wallbox).

Available options:
,
free_standing,
wall
Example:

"wall"

sticker
string

Identifier printed on the physical sticker on the station.

Maximum string length: 100
color
string

Colour of the enclosure (e.g. "RAL 7016 anthracite").

Maximum string length: 50
automatic_rebootable_rccb
boolean
default:false

Whether the RCCB can be reset automatically by the controller after a trip.

house_connection_box
boolean
default:false

Whether the station has a dedicated house connection box (Hausanschlusskasten).

connection_cable
string

Connection cable specification (length, cross-section, type).

Maximum string length: 100
closing
string

Lock / closing mechanism (e.g. lock cylinder code).

Maximum string length: 200
Example:

"padlock type"

building_level
string

Building floor / level (e.g. "B1", "Ground", "Level 3").

Maximum string length: 20
Example:

"UG1"

parking_fees
string

Parking fees that apply when using the station.

Maximum string length: 200
crash_protection
boolean
default:false

Whether crash protection (bollards, barriers) is installed.

mark
string

Marking / labelling on the enclosure used for asset tracking.

Maximum string length: 200
comment
string

Comment shown to operators.

Maximum string length: 500
ceiling_height
number<float>

Ceiling clearance above the station in metres. Relevant for indoor installations with vehicle height restrictions.

investment_manager
string

Person or department responsible for the capex / investment side.

Maximum string length: 64
project
string

Name of the rollout project the station belongs to.

Maximum string length: 64
order_number
string

Purchase order number for the station hardware.

Maximum string length: 64
notification_number
string

Reference number used for official network operator notifications.

Maximum string length: 64
internal_comment
string

Internal comment. Not exported to public feeds.

Maximum string length: 500
upstream_supply_network
string

Identifies the upstream supply network feeding the station (e.g. transformer / feeder).

Maximum string length: 32
protective_switching_devices
string

Protective switch devices (RCCBs, MCBs) in the supply circuit.

Maximum string length: 64
Example:

"circuit breakers"

protective_switch_devices
string

Deprecated. Use protective_switching_devices instead. Ignored when protective_switching_devices is set.

Maximum string length: 64
Example:

"circuit breakers"

full_safeguarding
number<float>

Supply protection rating in amperes (Vorsicherung).

open_24_7
boolean
default:false

Whether the station is publicly accessible around the clock. When false, specific opening hours should be configured.

block_reservation
boolean
default:false

Whether the station is blocked from reservation outside its opening hours. When true, the station cannot be reserved during those periods.

article_number
string

Manufacturer / supplier article number.

Maximum string length: 16
conform_with_calibration_law
boolean
default:false

Whether the station is compliant with the German calibration law (Eichrecht). Required for legally compliant billing and must reflect the actual hardware certification status.

has_payment_terminal
boolean
default:false

Whether the station has an integrated payment terminal for direct card or contactless payment, enabling ad-hoc payment without app or RFID.

iso_instance
string

Identifies the ISO 15118 instance configured on the station. Required for Plug & Charge and vehicle-to-grid communication.

Maximum string length: 64
calibration_law_deadline
string<date>

Expiry date of the calibration-law certification. After this date the station may not be used for legally compliant billing until recertified.

Pattern: ^\d{4}-\d{2}-\d{2}$

Response

The updated charging station.

station
object
required

The charging station record with its charge points, location, controller and hardware data.