Skip to main content
GET
Get a charger

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.

FlowClient Credentials
Token URL
https://app.plugchoice.com/oauth/token

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

charger_id
string<uuid>
required

Response

OK

A charger as a caller sees it.

id
string<uuid>
required
identity
string
required

OCPP Chargepoint ID.

connection_status
enum<string>
required
Available options:
never_seen,
offline,
online
connectors
object[]
required
device_type
enum<string>
required

The kind of device. Only chargers for now; another type is 422 unsupported-device-type.

Available options:
charger
site_id
string<uuid>
required
capabilities
object
required

What a host can offer for the charger, before it shows a button. More may be added (start_charging, …); ignore the ones you don't know.

created_at
string<date-time>
required
vendor
string | null

As reported in BootNotification.

model
string | null
serial_number
string | null
firmware_version
string | null
last_connection_at
string<date-time> | null
status
enum<string> | null

OCPP 1.6 status of connector 0, null until reported.

Available options:
Available,
Faulted,
Unavailable,
null
external_user_id
string | null

The user of yours whose site it is, if any. Always null for a Plugchoice user.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9._:@-]+$
reference
string | null

Your label for it (charger_reference from the client session that added it; for a Plugchoice user, their current team's label).

setup
object | null

The charger's electrical setup.

The link session that added it; null for chargers added outside Link.