Skip to main content
GET
/
api
/
v3
/
chargers
/
{charger_uuid}
/
logs
List charger logs
curl --request GET \
  --url https://app.plugchoice.com/api/v3/chargers/{charger_uuid}/logs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filter": [],
  "sort": "created_at"
}
'
{
  "data": [
    {
      "uuid": "019ba578-248b-704e-8b8f-0068ae40899f",
      "charger_uuid": "1",
      "status": "pending",
      "version": "ocpp1.6",
      "method": "GetCompositeSchedule",
      "destination": "charger",
      "params": "[]",
      "result": null,
      "created_at": "2026-01-10T01:14:32.000000Z",
      "updated_at": "2026-01-10T01:14:32.000000Z"
    },
    {
      "uuid": "019ba578-248f-7284-aac6-ec287fa8fbf2",
      "charger_uuid": "2",
      "status": "failed",
      "version": "ocpp1.6",
      "method": "InstallCertificate",
      "destination": "charger",
      "params": "[]",
      "result": null,
      "created_at": "2026-01-10T01:14:32.000000Z",
      "updated_at": "2026-01-10T01:14:32.000000Z"
    }
  ],
  "links": {
    "first": "/?page=1",
    "last": null,
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "current_page_url": "/?page=1",
    "from": 1,
    "path": "/",
    "per_page": 25,
    "to": 2
  }
}

Authorizations

​
Authorization
string
header
required

See the documentation for more information.

Path Parameters

​
charger_uuid
string
required

Query Parameters

​
filter[method]
string

Filter by OCPP method (e.g., Heartbeat, StartTransaction)

Example:

"Heartbeat"

​
filter[status]
string

Filter by status (pending, done, failed)

Example:

"done"

​
filter[destination]
string

Filter by destination (centralsystem, charger)

Example:

"centralsystem"

​
filter[hide_insignificant]
string

Hide MeterValues and SetChargingProfile logs (0 or 1)

Example:

"1"

​
filter[date_from]
string

Filter logs from this date (Y-m-d or Y-m-d H:i:s)

Example:

"2025-01-01"

​
filter[date_to]
string

Filter logs until this date (Y-m-d or Y-m-d H:i:s)

Example:

"2025-12-31"

​
sort
string

Sort field (created_at). Prefix with - for descending. Default: -created_at

Example:

"-created_at"

​
page
integer

Page number for pagination

Example:

1

Body

application/json
​
filter
object
Example:
[]
​
sort
enum<string> | null
Available options:
created_at,
-created_at
Example:

"created_at"

Response

200 - application/json
​
data
object[]
Example:
[
  {
    "uuid": "019ba578-248b-704e-8b8f-0068ae40899f",
    "charger_uuid": "1",
    "status": "pending",
    "version": "ocpp1.6",
    "method": "GetCompositeSchedule",
    "destination": "charger",
    "params": "[]",
    "result": null,
    "created_at": "2026-01-10T01:14:32.000000Z",
    "updated_at": "2026-01-10T01:14:32.000000Z"
  },
  {
    "uuid": "019ba578-248f-7284-aac6-ec287fa8fbf2",
    "charger_uuid": "2",
    "status": "failed",
    "version": "ocpp1.6",
    "method": "InstallCertificate",
    "destination": "charger",
    "params": "[]",
    "result": null,
    "created_at": "2026-01-10T01:14:32.000000Z",
    "updated_at": "2026-01-10T01:14:32.000000Z"
  }
]
​
links
object
​
meta
object