List Logbook Events

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.plugchoice.com/v3/chargers/{charger}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.plugchoice.com/v3/chargers/{charger}/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.plugchoice.com/v3/chargers/{charger}/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.plugchoice.com/v3/chargers/{charger}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "type": "card_rejected_by_operator",
      "severity": "warning",
      "occurred_at": "2026-10-08T13:05:00.000000Z",
      "first_at": "2026-10-08T13:05:00.000000Z",
      "count": 1,
      "connector_id": null,
      "operator": "ocpp.example.com",
      "details": {
        "id_tag": "AA9CD0F7",
        "reason": "Invalid",
        "answered_by": "hub",
        "authority": "configured"
      },
      "log_id": 81234
    }
  ],
  "next_cursor": "WyIyMDI2LTEwLTA4IDEzOjA1OjAwIiw4MTIzNF0",
  "operators": {
    "ocpp.example.com": "Example Operator",
    "hub": "Plugchoice"
  },
  "cards": {
    "AA9CD0F7": "Office card"
  },
  "card_access": {},
  "filter_options": {
    "operators": ["hub", "ocpp.example.com"]
  }
}

GET

chargers

{charger}

events

List Logbook Events

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.plugchoice.com/v3/chargers/{charger}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.plugchoice.com/v3/chargers/{charger}/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.plugchoice.com/v3/chargers/{charger}/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.plugchoice.com/v3/chargers/{charger}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "type": "card_rejected_by_operator",
      "severity": "warning",
      "occurred_at": "2026-10-08T13:05:00.000000Z",
      "first_at": "2026-10-08T13:05:00.000000Z",
      "count": 1,
      "connector_id": null,
      "operator": "ocpp.example.com",
      "details": {
        "id_tag": "AA9CD0F7",
        "reason": "Invalid",
        "answered_by": "hub",
        "authority": "configured"
      },
      "log_id": 81234
    }
  ],
  "next_cursor": "WyIyMDI2LTEwLTA4IDEzOjA1OjAwIiw4MTIzNF0",
  "operators": {
    "ocpp.example.com": "Example Operator",
    "hub": "Plugchoice"
  },
  "cards": {
    "AA9CD0F7": "Office card"
  },
  "card_access": {},
  "filter_options": {
    "operators": ["hub", "ocpp.example.com"]
  }
}

Returns the charger’s logbook: the events in its OCPP log that matter to an owner, newest first. A refused card, a fault and its recovery, a transaction that started or ended, a restart, a command the charger refused or did not answer, and what the proxy saw between the charger and its operators. Each event points back at the OCPP call it was read from, so you can open the full message with List Logs. The response carries codes, not sentences. Write the line in your own language from type and details.

string

required

The UUID of the charger.

string[]

Only these event types. Accepts an array or a comma-separated list. See type below for the values.

string[]

Only these severities: info, warning, critical. Use warning,critical for the problems alone.

string[]

Only events that involve these operators, as the proxy names them (see operator below). Accepts an array or a comma-separated list. filter_options.operators lists the operators set on this charger.

integer[]

Only events on these connectors. Use 0 for the charger as a whole. Accepts an array or a comma-separated list.

string

Events from this moment on. Any date or ISO 8601 timestamp.

string

Events up to this moment. Must be after or equal to filter[date_from].

string

The next_cursor of the previous page. Leave it out for the newest events.

integer

Events per page, 1 to 100. Defaults to 25.

Response

object[]

The events, newest first. A run of the same event in a row (the same card refused four times) is one event with a count.

Show event

string

What happened. One of card_rejected, card_rejected_by_operator, session_started, session_stopped, connector_faulted, connector_recovered, connector_unavailable, charger_booted, command_failed, firmware_installed, firmware_failed, operator_failover, no_operator_reachable, message_lost.card_rejected means the answer the charger acted on refused the card. card_rejected_by_operator means another operator refused it while the charger still got permission to charge.

string

info, warning or critical.

string

ISO 8601 timestamp of the event, or of the latest one in a run.

string

ISO 8601 timestamp of the first event in a run. Equal to occurred_at when count is 1.

integer

How many identical events in a row this line stands for.

integer

The connector, 0 for the charger as a whole, or null when the event has no connector.

string

The operator involved, as the proxy names it: hub for Plugchoice, proxy when the proxy answered itself, otherwise the operator’s host. Look up the display name in operators. May be null.For operator_failover it is the operator that stood in; details.leader is the operator that handles billing and did not answer.

object

The facts the event is written from. Depends on type: id_tag, reason and authority for a refused card (configured when the answer came from the operator that handles billing, failover when another operator stood in), plus leader for a card_rejected during a failover and answered_by for card_rejected_by_operator; id_tag and transaction_id for a started transaction; reason and transaction_id for a stopped one; leader for operator_failover; status, error_code, info and vendor_error_code for a fault; status for a recovery and for a failed firmware update; command and outcome for a command the charger refused or did not answer; firmware and status for a boot; message for a lost message.

integer

The ID of the OCPP call the event was read from.

string

Pass it as before to get the next, older page. null on the last page.One page reads at most 14 days of log. When those 14 days hold no events, data is empty and next_cursor points further back, so keep paging until next_cursor is null.

object

The display name for each operator on this page, keyed by the operator value. hub is Plugchoice; a host of a known operator gets its name.

object

The name the location gave each card on this page, keyed by id_tag. Cards without a name are left out.

object

Where each card refused on this page (card_rejected) stands on the card list of the charger’s location today, keyed by id_tag. Matched exactly, the way Plugchoice matches a card when it decides. A card that is not on the list is left out.

Show card access

string

allowed when the card may charge on this charger now, other_chargers when it is on the list but only for other chargers at the location.

string

The ID of the card at the location, for Update Card.

string

The name the location gave the card.

string[]

The UUIDs of the chargers the card is limited to. Empty means every charger at the location.

The values you can filter on.

Show filter_options

string[]

The operators set on this charger, as the proxy names them: hub first, then each other operator’s host. Their display names are in operators.

{
  "data": [
    {
      "type": "card_rejected_by_operator",
      "severity": "warning",
      "occurred_at": "2026-10-08T13:05:00.000000Z",
      "first_at": "2026-10-08T13:05:00.000000Z",
      "count": 1,
      "connector_id": null,
      "operator": "ocpp.example.com",
      "details": {
        "id_tag": "AA9CD0F7",
        "reason": "Invalid",
        "answered_by": "hub",
        "authority": "configured"
      },
      "log_id": 81234
    }
  ],
  "next_cursor": "WyIyMDI2LTEwLTA4IDEzOjA1OjAwIiw4MTIzNF0",
  "operators": {
    "ocpp.example.com": "Example Operator",
    "hub": "Plugchoice"
  },
  "cards": {
    "AA9CD0F7": "Office card"
  },
  "card_access": {},
  "filter_options": {
    "operators": ["hub", "ocpp.example.com"]
  }
}

Get started

Users

Teams

Locations

Chargers

Data

List Logbook Events

Response

​Response

Response