Skip to main content
With the Plugchoice API, your own systems can do what you do in the Plugchoice dashboard: see your chargers and their status, start and stop charging, manage locations and charge cards, and read charging sessions and energy use.

​
What you can do

Chargers

List your chargers, see their status, change their settings and update their firmware.

Charging

Start and stop charging, or restart a charger.

Locations and teams

Organise chargers by location and team, and manage who may charge with charge cards.

Sessions and energy

Read charging sessions and meter values, and export energy use.

​
Make your first request

1

Create a token

In the dashboard, go to Settings › Personal Access Tokens and create a token. Copy it: it’s shown only once.
2

Call the API

Send the token in the Authorization header. This asks who you are:
3

List your chargers

The API reference lets you try every endpoint from the page.
Building something other people sign in to? Use OAuth 2.0 instead of a personal token: see Authentication.

​
How it’s organised

  • Teams are at the top. You can belong to more than one.
  • Locations are the places with chargers. Each belongs to a team.
  • Chargers are at a location.
  • Connectors are the plugs on a charger. A charger has one or more.
The API calls locations sites, as in /v3/sites.

​
Good to know

Every endpoint lives under https://api.plugchoice.com/v3, takes JSON and answers with JSON.
Endpoints that list things answer one page at a time. Pagination
Too many requests in a short time get 429 Too Many Requests. Rate limiting
Errors use the usual HTTP status codes, with a message in the body. Errors

Building an app for EV drivers?

The Plugchoice SDK lets the people using your app connect their charger in a few taps, without leaving your app.