Skip to main content
POST
Creates a station

Authorizations

Authorization
string
header
required

OAuth2 Bearer Authorization

Body

application/json

Creates a station. Required permission: asset:stations:create

location_uuid
string
required

The UUID of the location this station belongs to. A station must always be assigned to exactly one location and cannot be reassigned after creation.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
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

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

evse
string

The EVSE identifier(s) associated with the charge points of this station.

Maximum string length: 50
charging_technology
enum<string>

The charging technology supported by this station (e.g. AC, DC). Determines the power delivery method and is used for filtering and display in the app.

Available options:
inductive,
conductive
position
string

A free-text description of the physical position of the station within the location.

Maximum string length: 100
Example:

"parking bay 3"

vehicle_type
enum<string>

The type of vehicle this station is designed to charge.

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

"truck"

status
enum<string>

The current lifecycle status of the station. Possible values include: In Planning, Under Construction, Factory Acceptance Test (FAT), Demo, In Operation, Defective, Out of Service, and Decommissioned.

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

The planned start or project kick-off date for this station. Used for project tracking and internal planning purposes.

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

The target commissioning date by which the station should be operational. Used for project management and installation scheduling.

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

The date on which 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>

The date on which the station was taken out of service or marked as defective.

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

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

Maximum string length: 5
particularities
string

A short free-text field for noting any special characteristics or exceptions of this station.

Maximum string length: 64
manufacturer
string

The name of the hardware manufacturer of the charging station.

Maximum string length: 100
model
string

The hardware model designation of the charging station as specified by the manufacturer.

Maximum string length: 100
green_power
boolean
default:false

Indicates whether this station is supplied with certified renewable energy. This value is transmitted to roaming partners and may be displayed in the app.

vehicle_communication_type_id
integer<int32>

The ID referencing the vehicle-to-grid communication standard supported by this station (e.g. ISO 15118). Used for advanced charging features such as Plug & Charge.

serial_number
integer<int32>

The manufacturer-assigned serial number of the charging station hardware.

mounting_type
enum<string>

The physical installation type of the station

Available options:
,
free_standing,
wall
Example:

"wall-mounted"

sticker
string

A reference to labeling or sticker information applied to the station (e.g. branding sticker ID or label text).

Maximum string length: 100
color
string

The color of the station enclosure.

Maximum string length: 50
automatic_rebootable_rccb
boolean
default:false

Indicates whether the station is equipped with an automatically resettable residual current circuit breaker. When true, the system can trigger a remote reboot to recover the RCCB after a trip.

house_connection_box
boolean
default:false

Indicates whether a house connection box is present at this station's installation.

connection_cable
string

Describes the type or specification of the power supply cable connecting the station to the grid.

Maximum string length: 100
closing
string

Information about the locking or access mechanism of the station.

Maximum string length: 200
Example:

"padlock type"

building_level
string

The floor or building level where the station is installed. Useful for multi-storey parking structures and indoor installations.

Maximum string length: 20
Example:

"UG1"

parking_fees
string

Information about applicable parking fees at the station's location.

Maximum string length: 200
crash_protection
boolean
default:false

Indicates whether physical crash protection (e.g. bollards or barriers) has been installed around the station.

mark
string

A free-text marking or label used to identify or categorize the station internally (e.g. a project code or custom tag).

Maximum string length: 200
comment
string

A general comment about the station visible to backend users. Used for operational notes that do not fit into other structured fields.

Maximum string length: 500
ceiling_height
number<float>

The ceiling height at the station's installation location, in meters. Relevant for indoor installations where vehicle height restrictions may apply.

investment_manager
string

The name of the person or organization responsible for the investment decision behind this station.

Maximum string length: 64
project
string

The name or identifier of the project this station belongs to.

Maximum string length: 64
order_number
string

The procurement or work order number associated with this station.

Maximum string length: 64
notification_number
string

A reference number used for official network operator notifications.

Maximum string length: 64
internal_comment
string

An internal-only comment field for backend operators. Not visible in any public-facing output.

Maximum string length: 500
upstream_supply_network
string

Identifies the upstream electrical supply network feeding this station.

Maximum string length: 32
protective_switch_devices
string

Describes the protective switching devices installed in the station's electrical circuit.

Maximum string length: 64
Example:

"circuit breakers"

full_safeguarding
number<float>

The total electrical fuse rating protecting this station's supply circuit, in amperes.

open_24_7
boolean
default:false

Indicates whether the station is accessible around the clock without time restrictions. When false, specific opening hours should be configured.

block_reservation
boolean
default:false

Indicates whether the station supports blocking a charge point for a reservation period. When enabled, users can reserve a connector in advance via the app.

article_number
string

The manufacturer's article or part number for this station model.

Maximum string length: 16
conform_with_calibration_law
boolean
default:false

Indicates whether the station is compliant with calibration law requirements. This setting is required for legally compliant billing of charging sessions and must reflect the actual hardware certification status.

has_payment_terminal
boolean
default:false

Indicates whether the station is equipped with an integrated payment terminal for direct card or contactless payment. Relevant for stations that support ad-hoc payment without app or RFID.

iso_instance
string

The identifier of the ISO 15118 instance configured on this station. Required for Plug & Charge setups and vehicle-to-grid communication based on the ISO 15118 standard.

Maximum string length: 64
calibration_law_deadline
string<date>

The expiry date of the station's calibration law certification. After this date, the station may no longer be used for legally compliant billing until recertified.

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

Response

Station created

station
object
required

Station