Skip to main content
GET
List Logs
Returns a paginated list of OCPP communication logs for a specific charger. Supports filtering by method, status, destination, date range, and sorting.
string
required
The UUID of the charger.
string[]
Filter by OCPP method (e.g., Heartbeat, StartTransaction, MeterValues). Accepts an array or a comma-separated list of values.
string[]
Filter by log status. One or more of pending, done, or failed. Accepts an array or a comma-separated list of values.
string[]
Filter by message destination. One or more of centralsystem or charger. Accepts an array or a comma-separated list of values.
string
Hide high-volume, low-significance logs (Heartbeat, MeterValues, SetChargingProfile, SecurityEventNotification, GetConfiguration, and ChangeConfiguration). Use 1 to hide or 0 to show.
string
Filter logs from this date. Format: Y-m-d or Y-m-d H:i:s.
string
Filter logs until this date. Must be after or equal to filter[date_from]. Format: Y-m-d or Y-m-d H:i:s.
string
Sort field. Use created_at for ascending or -created_at for descending (default).
integer
Page number for pagination.

Response

The response is a paginated payload (simplePaginate, 25 per page). Log entries are returned in the data array, alongside the standard pagination fields (current_page, per_page, first_page_url, prev_page_url, next_page_url, from, to, path) and the additional filter_options field described below.
object[]
The list of log entries. Each entry has the following fields.
object
The display name for each operator on this page and each operator set on the charger, keyed by the label the proxy uses: hub and proxy are Plugchoice, a host of a known operator gets its name, any other host stays as it is.
object
Available filter options.