Notify Event
Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.38 (Messages); Use Cases N07 — Alert Event, N08 — Periodic Event (Functional Block N. Diagnostics)
Overview
The Charging Station sends NotifyEventRequest to deliver Device Management monitoring events to the CSMS. Each event corresponds to a Component / Variable / VariableMonitoring triple where a configured monitor was triggered (alert, threshold, delta, periodic).
A single message may carry multiple events (CS may group events triggered at the same time). Long event lists are split across multiple messages using seqNo and the tbc flag.
In OCPP 2.0.1 this mechanism is also expected to eventually replace StatusNotification and MeterValues (which are flagged as candidates for removal in future versions).
Sequence Diagram
Charging Station ──── NotifyEventRequest ────▶ CSMS
(generatedAt, tbc?, seqNo, eventData[])
Charging Station ◀─── NotifyEventResponse ──── CSMS
(repeated until tbc = false)
Initiator
Charging Station → CSMS
Fields
| Field Name | Field Type | Card. | Description |
|---|---|---|---|
| generatedAt | dateTime | 1..1 | Required. Timestamp at the Charging Station when the message was generated. |
| tbc | boolean | 0..1 | Optional. "To be continued" indicator. Default false. |
| seqNo | integer | 1..1 | Required. Sequence number. First message starts at 0. |
| eventData | EventDataType | 1..* | Required. List of EventData. Each contains the Component, Variable and VariableMonitoring data that caused the event. |
No fields are defined.
EventDataType (selected fields)
| Field | Type | Card. | Description |
|---|---|---|---|
| eventId | integer | 1..1 | Identifies the event. |
| timestamp | dateTime | 1..1 | When the event occurred. |
| trigger | EventTriggerEnumType | 1..1 | Alerting / Delta / Periodic. |
| cause | integer | 0..1 | If applicable, the eventId of the cause. |
| actualValue | string [0..2500] | 1..1 | Actual value of the Variable. |
| component | ComponentType | 1..1 | Component for which the event was reported. |
| variable | VariableType | 1..1 | Variable for which the event was reported. |
| eventNotificationType | EventNotificationEnumType | 1..1 | HardWiredNotification / HardWiredMonitor / PreconfiguredMonitor / CustomMonitor. |
| severity | integer | 1..1 | Severity 0 (Danger) … 9 (Debug). |
Examples
{
"generatedAt": "2026-04-27T12:34:56Z",
"seqNo": 0,
"eventData": [
{
"eventId": 4242,
"timestamp": "2026-04-27T12:34:55Z",
"trigger": "Alerting",
"actualValue": "85.2",
"component": { "name": "EVSE", "evse": { "id": 1 } },
"variable": { "name": "Temperature" },
"eventNotificationType": "HardWiredMonitor",
"severity": 4
}
]
}{}Schema
Source:
schemas/NotifyEventRequest.json,schemas/NotifyEventResponse.json(OCPP 2.0.1 FINAL)