Skip to main content

Get local list version

POST 
/chargers/:id/actions/get-local-list-version

Sends an OCPP GetLocalListVersion command to request the current version number of the charger's local authorization list.

Use Cases:

  • Verify local list synchronization status
  • Check if local list update was successful
  • Determine if differential update can be used
  • Audit local authorization list versions across fleet
  • Troubleshoot offline authorization issues

Version Number:

  • Integer version number incremented with each list update
  • Version 0 or -1 indicates no local list present
  • Used to track synchronization between central system and charger
  • Supports differential updates (only send changes since last version)

What Gets Returned:

  • Current version number of local authorization list
  • Version -1 if charger does not support local list
  • Version 0 if local list never configured

Best Practices:

  • Check version before sending differential updates
  • Compare version across chargers to identify synchronization gaps
  • Store expected version in central system for validation
  • Request version after SendLocalList to confirm success
  • Use for health checks and monitoring

Request​

Responses​

Standard success response for actions