List Logs

GET /v3/chargers/{charger}/logs

List Logs

cURL

curl --request GET \
  --url https://app.plugchoice.com/api/v3/chargers/{charger}/logs \
  --header 'Authorization: Bearer <token>'

200

{
  "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.

Show filter_options

methods · string[]

A list of all available OCPP method names that can be used with the filter[method] parameter.