Skip to main content
POST
Create Charger
Registers a new charger. The charger is assigned to the authenticated user’s team. If the user does not have a team, a personal team is automatically created.
identity
string
required
The unique identity string for the charger (e.g., serial number). Maximum 45 characters. Must be unique across all chargers.
team_uuid
string
The UUID of the team to assign the charger to. Must be a valid UUID of an existing team.
site_uuid
string
The UUID of the location to assign the charger to. Must be a valid UUID of an existing location.

Response

uuid
string
The unique UUID of the charger.
id
integer
The numeric ID of the charger.
identity
string
The unique identity string of the charger.
serial_number
string
The serial number of the charger. May be null.
pincode
string
The charger’s pincode. Only returned if the authenticated user has sensitive permissions.
reference
string
A user-defined reference for the charger. May be null.
connection_status
string
The current connection status of the charger.
status
string
The current OCPP status of the charger.
error
string
The current error code, if any. May be null.
error_info
string
Additional error information. May be null.
vendor_id
string
The vendor identifier. May be null.
vendor_error_code
string
A vendor-specific error code. May be null.
firmware_version
string
The raw firmware version string. May be null.
parsed_firmware_version
string
The parsed and normalized firmware version. May be null.
server
string
The OCPP server the charger is connected to. May be null.
last_connection_at
string
ISO 8601 timestamp of the last connection. May be null.
last_disconnection_at
string
ISO 8601 timestamp of the last disconnection. May be null.
last_heartbeat_at
string
ISO 8601 timestamp of the last heartbeat. May be null.
setup_pending
boolean
Whether the charger has a pending setup operation.
setup_completed
boolean
Whether the charger has completed initial setup.
blocked
boolean
Whether the charger is blocked.
max_current
number
The maximum current in Amperes the charger can deliver.
created_at
string
ISO 8601 timestamp of when the charger was created.
updated_at
string
ISO 8601 timestamp of when the charger was last updated.
licenses
object
The charger’s active licenses.
model_id
integer
The ID of the charger model. May be null.
is_mid
boolean
Whether the charger is a MID-certified meter. May be null.
permissions
object
The authenticated user’s permissions for this charger.