Skip to main content
GET
Get a transaction

Authorizations

Authorization
string
header
required

Your integration's client credentials (test or live). The token acts as your integration's team and lasts 1 hour; request a new one when it expires. Send client_id, client_secret and grant_type=client_credentials. No OAuth scopes are needed.

Headers

Plugchoice-Version
enum<string>

The API version to answer with (400 unknown-version for one this API does not know). Every response carries the version that answered in the same header.

Available options:
2026-10-07

Path Parameters

transaction_id
integer
required

Response

OK

id
integer
required
charger_id
string<uuid>
required
connector_id
integer | null
required

The connector number, as the charger numbers it.

status
enum<string>
required

active while it charges, completed once it stopped.

Available options:
active,
completed
started_at
string<date-time>
required
stopped_at
string<date-time> | null
required
energy_kwh
number | null
required

Charged so far for an active one, in total once completed. Null before the first meter reading.

Example:

7.5

stop_reason
string | null
required

The OCPP stop reason, or AutoClosed when Plugchoice closed it.

Example:

"EVDisconnected"

card
string | null
required

A hash of the card used, the same for the same card for your integration. Null without a card, or once the card id was removed.

Example:

"3f9c1a0e5b7d4c2a8e6f0b1d9a7c5e3f"

imported
boolean
required

Imported, from the charger brand's cloud when the charger came to Plugchoice or through the Plugchoice API, rather than reported by the charger.