OCPP 2.0.1 Message Reference
Complete reference for all 64 OCPP 2.0.1 messages. Each page includes required fields, example payloads, common errors, and links to the validator and builder tools.
Core (10 messages)
Sent by the Charging Station to notify the CSMS that it has booted and is ready to accept messages. Includes a reason for booting and a structured ChargingStation object.
Sent by the Charging Station to indicate it is still connected and operational. The CSMS responds with the current time for clock synchronization.
Sent by the Charging Station to request authorization for an identifier before starting a transaction. In OCPP 2.0.1, the identifier is an IdToken object supporting multiple token types including RFID, eMAID, and ISO 15118.
Reports transaction lifecycle events to the CSMS. Replaces StartTransaction and StopTransaction from OCPP 1.6J with a unified event-based model using Started, Updated, and Ended event types.
Sent by the Charging Station to report the current status of a connector on a specific EVSE. Uses the new EVSE/connector model and a simplified connector status enum.
Sent by the Charging Station to report meter readings for a specific EVSE. Used for periodic energy reporting outside of a TransactionEvent.
Sent by the Charging Station to report a security-related event, such as a failed authentication attempt, tamper detection, or firmware signature failure.
Sent by the CSMS to update the running cost of a transaction in real-time, enabling the Charging Station to display the current cost to the driver.
Sent by the CSMS to check whether a specific transaction is still ongoing and whether any transaction-related messages are still pending delivery.
Sent by the CSMS to clear the Charging Station's authorization cache.
Remote Control (6 messages)
Sent by the CSMS to remotely start a transaction on a Charging Station. Replaces RemoteStartTransaction from OCPP 1.6J with a richer model including remoteStartId for request tracking.
Sent by the CSMS to remotely stop an ongoing transaction. Replaces RemoteStopTransaction from OCPP 1.6J.
Sent by the CSMS to request a reset of the Charging Station. Supports Immediate and OnIdle reset types.
Sent by the CSMS to change the operational status of an EVSE or connector. Supports setting it Operative or Inoperative.
Sent by the CSMS to request the Charging Station to send a specific message. Useful for diagnostics, status checks, and forcing reports.
Sent by the CSMS to unlock a connector on a specific EVSE, allowing the cable to be removed.
Configuration (6 messages)
Sent by the CSMS to retrieve one or more variable values from the Charging Station. Replaces GetConfiguration from OCPP 1.6J with a structured Component/Variable model.
Sent by the CSMS to update one or more configuration variable values on the Charging Station. Replaces ChangeConfiguration from OCPP 1.6J.
Sent by the CSMS to request the Charging Station to generate a report containing all its configuration variables. The report is delivered via NotifyReport messages.
Sent by the Charging Station to deliver the results of a GetBaseReport or GetReport request. May be split across multiple messages for large reports.
Sent by the CSMS to request a custom report of specific variables from the Charging Station, using component/variable criteria.
Sent by the CSMS to configure a network connection profile on the Charging Station, including CSMS URL, security settings, and network interface parameters.
Smart Charging (9 messages)
Sent by the CSMS to set or update a charging profile on a specific EVSE, controlling the power delivery schedule during a transaction.
Sent by the CSMS to remove one or more charging profiles from the Charging Station.
Sent by the CSMS to retrieve charging profiles currently installed on the Charging Station.
Sent by the CSMS to request the effective charging schedule for an EVSE over a specified duration, combining all applicable charging profiles.
Sent by the Charging Station to inform the CSMS about a local charging limit imposed by the station's energy management system, such as from a local controller or grid signal.
Sent by the Charging Station to inform the CSMS that a previously reported local charging limit has been lifted.
Sent by the Charging Station to report the charging requirements communicated by the EV via ISO 15118, including desired energy, departure time, and AC/DC charging parameters.
Sent by the Charging Station to forward the charging schedule proposed by the EV via ISO 15118 power delivery negotiation.
Sent by the Charging Station to deliver the results of a GetChargingProfiles request, reporting the currently installed charging profiles.
Firmware Management (7 messages)
Sent by the CSMS to instruct the Charging Station to download and install a firmware update from a given URL.
Sent by the Charging Station to report the progress of a firmware update. Each step of the update process sends a new notification.
Sent by the CSMS to request the Charging Station to upload a log file to a specified location.
Sent by the Charging Station to report the status of a log file upload requested by GetLog.
Sent by the CSMS to a Local Controller to instruct it to download and make available a firmware file for local distribution to Charging Stations on its local network.
Sent by the Local Controller to report the status of a firmware publish operation initiated by PublishFirmware.
Sent by the CSMS to a Local Controller to stop serving a previously published firmware file.
Monitoring (7 messages)
Sent by the Charging Station to report monitoring events triggered by variable monitors previously configured via SetVariableMonitoring.
Sent by the CSMS to request a report of all variable monitors currently configured on the Charging Station.
Sent by the Charging Station to deliver the results of a GetMonitoringReport request, listing all configured variable monitors.
Sent by the CSMS to configure monitors on specific variables. When a monitor triggers, the Charging Station sends a NotifyEvent.
Sent by the CSMS to remove one or more variable monitors from the Charging Station.
Sent by the CSMS to configure the base monitoring level on the Charging Station, activating a predefined set of factory-default monitors.
Sent by the CSMS to set the minimum severity level for which the Charging Station will send NotifyEvent messages.
Reservation (3 messages)
Sent by the CSMS to reserve an EVSE for a specific identifier. The EVSE will be held until the reservation expires or is cancelled.
Sent by the CSMS to cancel an existing reservation on the Charging Station.
Sent by the Charging Station to inform the CSMS about a change in reservation status, such as when a reservation expires or is fulfilled.
Certificate Management (7 messages)
Sent by the Charging Station to request the CSMS to sign a certificate signing request (CSR) for the station's TLS certificate or V2G certificate.
Sent by the CSMS to deliver a signed certificate to the Charging Station in response to a SignCertificate request.
Sent by the CSMS to install a root CA certificate on the Charging Station for validating CSMS TLS certificates or V2G certificates.
Sent by the CSMS to remove a specific certificate from the Charging Station's certificate store.
Sent by the CSMS to retrieve the list of certificates currently installed on the Charging Station.
Sent by the Charging Station to request the revocation status of a certificate via OCSP, enabling it to validate EV certificates during ISO 15118 authentication.
Sent by the Charging Station to retrieve an EV's V2G certificate from the CSMS during ISO 15118 Plug and Charge authentication.
Local Auth List (2 messages)
Display Management (4 messages)
Sent by the CSMS to display a message on the Charging Station's screen, either immediately or at a scheduled time.
Sent by the CSMS to remove a specific message from the Charging Station's display.
Sent by the CSMS to retrieve all display messages currently stored on the Charging Station.
Sent by the Charging Station to deliver the list of stored display messages in response to a GetDisplayMessages request.
Customer Information (2 messages)
Sent by the CSMS to request or clear customer-related information stored on the Charging Station, such as transaction history or authorization data for a specific customer.
Sent by the Charging Station to deliver customer-related data in response to a CustomerInformation request.