Skip to main content
GET
/
v3
/
chargers
/
{charger}
/
logs
List Logs
curl --request GET \
  --url https://app.plugchoice.com/api/v3/chargers/{charger}/logs \
  --header 'Authorization: Bearer <token>'
{
  "id": 123,
  "charger_id": 123,
  "status": "<string>",
  "version": "<string>",
  "method": "<string>",
  "destination": "<string>",
  "params": {},
  "result": {},
  "created_at": "<string>",
  "updated_at": "<string>",
  "filter_options": {
    "methods": [
      "<string>"
    ]
  }
}
Returns a paginated list of OCPP communication logs for a specific charger. Supports filtering by method, status, destination, date range, and sorting.
​
charger
string
required
The UUID of the charger.
​
filter[method]
string
Filter by OCPP method (e.g., Heartbeat, StartTransaction, MeterValues).
​
filter[status]
string
Filter by log status. One of pending, done, or failed.
​
filter[destination]
string
Filter by message destination. One of centralsystem or charger.
​
filter[hide_insignificant]
string
Hide MeterValues and SetChargingProfile logs. Use 1 to hide or 0 to show.
​
filter[date_from]
string
Filter logs from this date. Format: Y-m-d or Y-m-d H:i:s.
​
filter[date_to]
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.
​
sort
string
Sort field. Use created_at for ascending or -created_at for descending (default).
​
page
integer
Page number for pagination.

​
Response

​
id
integer
The log entry ID.
​
charger_id
integer
The ID of the charger.
​
status
string
The status of the OCPP message (e.g., pending, done, failed).
​
version
string
The OCPP protocol version used.
​
method
string
The OCPP method name (e.g., Heartbeat, StartTransaction, StatusNotification).
​
destination
string
The message destination (centralsystem or charger).
​
params
object
The parameters sent with the OCPP message. Structure varies per OCPP action (e.g., BootNotification, StartTransaction).
​
result
object
The result or response of the OCPP message. Structure varies per OCPP action. May be null for pending messages.
​
created_at
string
ISO 8601 timestamp of when the log entry was created.
​
updated_at
string
ISO 8601 timestamp of when the log entry was last updated.
The response also includes a top-level field:
​
filter_options
object
Available filter options.