The Plugchoice REST API lets you build your own product on top of the platform: read chargers, sessions and meter values, start and stop charging, manage cards, sites and power management, and more. This page is the short version for partners; the full technical documentation is at developer.plugchoice.com.
Where the documentation lives
developer.plugchoice.com: the full API reference plus guides on authentication, errors, pagination and rate limiting.
Building with an AI assistant? Feed it developer.plugchoice.com/llms.txt (the index) or llms-full.txt (the entire documentation in one file). Your AI coding tool can then answer questions about the API and write the integration for you.
Two ways to authenticate
Personal access token: the quickest start, for your own use of your own account, such as scripts, testing, home automation or your own dashboard. Create one in the web portal under Settings > Your account > API tokens with Create API token. Using a token in a product or service for others, or to reach other accounts' data, needs API Professional.
OAuth 2.0 (API Professional): for products your customers use. Your application gets its own access to each customer's data, with their permission and within the scopes they approve, without anyone sharing passwords or tokens. API Professional runs under a separate agreement on scopes, rate limits and fees.
What OAuth looks like for your customer
In your app, the customer clicks something like Connect Plugchoice.
They land on the Plugchoice sign-in screen and sign in with their own account, also possible with Google or Apple.
Plugchoice shows which access your app requests, and the customer approves it with Authorize.
They are sent back to your app, which now receives its own tokens for that customer.
Nobody copies tokens or shares passwords. The customer can withdraw the access at any time in the web portal under Settings > Your account > Connected apps (Revoke access), and for a single charger under the charger's Settings > Apps.
Your customers and their data
Your app uses a customer's data only within the scopes they approved and for your own service to that customer.
Ownership transfers, access grants and other consent steps are never automated: the user confirms each one.
Whoever gets a Plugchoice account through your app, Link or the API is a Plugchoice customer under our terms, unless a signed agreement gives you that customer relationship. We may inform these customers ourselves and show them the Plugchoice app.
When a customer revokes access or deletes their account, your app stops sending commands to their chargers, deletes the personal data it received through the API without undue delay, and deletes other API data within 30 days.
Getting access
OAuth is part of API Professional. Send us your redirect URL (the address in your app the customer returns to after approving) via the messenger or your partner contact. Once the agreement is in place, we set up your OAuth client and send you the credentials.
Personal access tokens need no setup from us: create one in the web portal and start building.