GetLocalListVersion
Asks the charge point which version of the local authorization list it currently holds.
- Version
- OCPP 1.6
- Direction
- CSMS → Charge Point
- Feature profile
- Local Auth List Management
GetLocalListVersion also exists in OCPP 2.0.1, with a different payload. See the OCPP 2.0.1 version.
The Local Authorization List lets a charge point authorize tokens with no backend connection at all. This message reads the version number the charger holds, so the CSMS can decide whether an update is needed.
Always read the version before pushing a differential update — that is the whole point of the message.
Request
No fields — the payload is an empty object {}.
[2, "19223201", "GetLocalListVersion", {}]Response
| Field | Type | Required | Description |
|---|---|---|---|
listVersion | integer | Required | Version held by the charge point. 0 means empty; -1 means the list is not supported. |
[3, "19223201", {
"listVersion": 42
}]Implementation notes
`-1` means unsupported, `0` means empty. These are entirely different situations and a CSMS that conflates them will keep pushing lists at a charger that cannot store them.
Version numbers are opaque integers chosen by the CSMS. They only need to increase.
The local list is distinct from the authorization cache: the list is pushed deliberately, the cache fills itself from Authorize responses.