Skip to main content
POST
Add Charger
Attaches an existing charger to the specified location using its identity and pincode.
site
string
required
The UUID of the location.
identity
string
required
The OCPP identity of the charger to attach. Maximum 255 characters.
pincode
number
required
The pincode of the charger (4–8 digits).

Response

Returns the attached charger.
uuid
string
The unique UUID of the charger.
id
integer
The numeric ID of the charger.
identity
string
The charger’s OCPP identity string.
serial_number
string
The charger’s serial number. May be null.
pincode
string
The charger’s pincode. Only included when the authenticated user has sensitive access to the charger.
reference
string
A custom reference label 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
integer
The maximum current in amps.
licenses
object
The charger’s active licenses.
model_id
integer
The ID of the charger model. May be null.
model
object
The charger model details. Only included when the model relationship is loaded.
internal_model
object
The internal model details. Only included when the internal model relationship is loaded, otherwise null.
is_mid
boolean
Whether the charger is MID-certified, derived from its internal or public model. May be null.
permissions
object
The authenticated user’s permissions for this charger.
connectors
array
An array of connector objects for this charger. Only included when the connectors relationship is loaded.
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.