Skip to main content

Send local authorization list

POST 
/chargers/:id/actions/send-local-list

Sends an OCPP SendLocalList command to update the charger's local authorization list for offline operation.

Use Cases:

  • Enable offline authorization when central system unavailable
  • Provision authorized users for remote or disconnected sites
  • Implement emergency fallback authorization
  • Pre-load authorization for expected users
  • Support offline-first deployment scenarios

Update Types:

  • Full: Replace entire local authorization list
  • Differential: Add/update/remove specific entries only
  • Clear: Empty the local list (use Full with empty list)

Local List Contents:

  • ID tags (RFID cards, mobile credentials, user IDs)
  • Authorization status (allowed/blocked)
  • Expiry dates for temporary access
  • Parent ID tags for group authorization

Authorization Flow:

  • Charger checks local list when central system unreachable
  • Local list used as fallback during connectivity issues
  • Central authorization always takes precedence when online
  • Local list persists across charger reboots

List Management:

  • Full Update: Sends complete list, replaces all entries
  • Differential Update: Only sends changes (adds/updates/deletes)
  • Version number tracks list updates for synchronization
  • List capacity varies by charger model (typically 100-10,000 entries)

Best Practices:

  • Use differential updates for small changes (faster)
  • Full updates for bulk provisioning or synchronization
  • Include expiry dates for temporary credentials
  • Monitor list version to track synchronization
  • Consider charger memory limits for large lists
  • Test offline authorization after sending list

Request​

Responses​

Standard success response for actions