# Plugchoice

- [Plugchoice API](https://developer.plugchoice.com/guides/introduction.md): Manage your EV chargers from your own systems: their status, charging, locations and energy use.
- [Authentication](https://developer.plugchoice.com/guides/authentication.md): Authenticate with the Plugchoice API using OAuth 2.0 or personal access tokens.
- [Pagination](https://developer.plugchoice.com/guides/pagination.md): Navigate large result sets with page-based pagination.
- [Rate limiting](https://developer.plugchoice.com/guides/rate-limiting.md): Understand API rate limits and how to handle them.
- [Errors](https://developer.plugchoice.com/guides/errors.md): How the Plugchoice API communicates errors and HTTP status codes.
- [Get Current User](https://developer.plugchoice.com/api-reference/users/get-current-user.md)
- [Delete User](https://developer.plugchoice.com/api-reference/users/delete-user.md)
- [List Teams](https://developer.plugchoice.com/api-reference/teams/list-teams.md)
- [Create Team](https://developer.plugchoice.com/api-reference/teams/create-team.md)
- [Delete Team](https://developer.plugchoice.com/api-reference/teams/delete-team.md)
- [List Chargers](https://developer.plugchoice.com/api-reference/team-chargers/list-team-chargers.md)
- [List Locations](https://developer.plugchoice.com/api-reference/team-sites/list-team-sites.md)
- [List Team Transactions](https://developer.plugchoice.com/api-reference/transactions/list-team-transactions.md)
- [List Locations](https://developer.plugchoice.com/api-reference/sites/list-sites.md)
- [Create Location](https://developer.plugchoice.com/api-reference/sites/create-site.md)
- [Get Location](https://developer.plugchoice.com/api-reference/sites/get-site.md)
- [Update Location](https://developer.plugchoice.com/api-reference/sites/update-site.md)
- [Delete Location](https://developer.plugchoice.com/api-reference/sites/delete-site.md)
- [List Chargers](https://developer.plugchoice.com/api-reference/site-chargers/list-site-chargers.md)
- [Add Charger](https://developer.plugchoice.com/api-reference/site-chargers/add-charger-to-site.md)
- [Remove Charger](https://developer.plugchoice.com/api-reference/site-chargers/remove-charger-from-site.md)
- [Reassign Charger](https://developer.plugchoice.com/api-reference/site-chargers/reassign-charger.md)
- [Move Charger](https://developer.plugchoice.com/api-reference/site-chargers/move-charger.md)
- [List Connectors](https://developer.plugchoice.com/api-reference/site-connectors/list-site-connectors.md)
- [List Groups](https://developer.plugchoice.com/api-reference/site-groups/list-groups.md)
- [Create Group](https://developer.plugchoice.com/api-reference/site-groups/create-group.md)
- [Update Group](https://developer.plugchoice.com/api-reference/site-groups/update-group.md)
- [Delete All Groups](https://developer.plugchoice.com/api-reference/site-groups/delete-all-groups.md)
- [Delete Group](https://developer.plugchoice.com/api-reference/site-groups/delete-group.md)
- [Create Subgroup](https://developer.plugchoice.com/api-reference/site-groups/create-subgroup.md)
- [Reassign Group](https://developer.plugchoice.com/api-reference/site-groups/reassign-group.md)
- [Assign Chargers to Group](https://developer.plugchoice.com/api-reference/site-groups/assign-chargers-to-group.md)
- [Get Group Meter](https://developer.plugchoice.com/api-reference/site-groups/get-group-meter.md)
- [Get Power Management](https://developer.plugchoice.com/api-reference/power-management/get-power-management.md)
- [Get Power History](https://developer.plugchoice.com/api-reference/power-management/get-power-history.md)
- [Get Smart Charging](https://developer.plugchoice.com/api-reference/power-management/get-smart-charging.md)
- [Update Smart Charging](https://developer.plugchoice.com/api-reference/power-management/update-smart-charging.md)
- [Get Energy Profile](https://developer.plugchoice.com/api-reference/site-energy-profile/get-energy-profile.md)
- [Update Energy Profile](https://developer.plugchoice.com/api-reference/site-energy-profile/update-energy-profile.md)
- [List Cards](https://developer.plugchoice.com/api-reference/cards/list-cards.md)
- [Add Card](https://developer.plugchoice.com/api-reference/cards/add-card.md)
- [Update Card](https://developer.plugchoice.com/api-reference/cards/update-card.md)
- [Delete Card](https://developer.plugchoice.com/api-reference/cards/delete-card.md)
- [List Seen Cards](https://developer.plugchoice.com/api-reference/cards/list-seen-cards.md)
- [List Chargers](https://developer.plugchoice.com/api-reference/chargers/list-chargers.md)
- [Create Charger](https://developer.plugchoice.com/api-reference/chargers/create-charger.md)
- [Get Charger](https://developer.plugchoice.com/api-reference/chargers/get-charger.md)
- [Update Charger](https://developer.plugchoice.com/api-reference/chargers/update-charger.md)
- [Delete Charger](https://developer.plugchoice.com/api-reference/chargers/delete-charger.md)
- [Setup Charger](https://developer.plugchoice.com/api-reference/chargers/setup-charger.md)
- [Get Support Snapshot](https://developer.plugchoice.com/api-reference/chargers/get-support-snapshot.md)
- [Get Firmware Status](https://developer.plugchoice.com/api-reference/chargers/get-firmware.md)
- [Update Firmware](https://developer.plugchoice.com/api-reference/chargers/update-firmware.md)
- [Set Firmware Auto-Update](https://developer.plugchoice.com/api-reference/chargers/auto-update-firmware.md)
- [Get Proxy Servers](https://developer.plugchoice.com/api-reference/chargers/get-proxy.md)
- [Update Proxy Servers](https://developer.plugchoice.com/api-reference/chargers/update-proxy.md)
- [Start Charging](https://developer.plugchoice.com/api-reference/charger-actions/start-charging.md)
- [Stop Charging](https://developer.plugchoice.com/api-reference/charger-actions/stop-charging.md)
- [Restart](https://developer.plugchoice.com/api-reference/charger-actions/restart-charger.md)
- [Set Charge Limit](https://developer.plugchoice.com/api-reference/charger-actions/set-charge-limit.md)
- [Set Charging Profile](https://developer.plugchoice.com/api-reference/charger-actions/set-charging-profile.md)
- [Clear Charging Profile](https://developer.plugchoice.com/api-reference/charger-actions/clear-charging-profile.md)
- [Get Composite Schedule](https://developer.plugchoice.com/api-reference/charger-actions/get-composite-schedule.md)
- [Bulk Command](https://developer.plugchoice.com/api-reference/charger-actions/bulk-command.md)
- [Get Bulk Command Run](https://developer.plugchoice.com/api-reference/charger-actions/get-bulk-command.md)
- [Get Lock Status](https://developer.plugchoice.com/api-reference/charger-settings/get-cable-lock.md)
- [Set Lock](https://developer.plugchoice.com/api-reference/charger-settings/set-cable-lock.md)
- [Get Socket Lock Status](https://developer.plugchoice.com/api-reference/charger-settings/get-socket-lock.md)
- [Set Socket Lock](https://developer.plugchoice.com/api-reference/charger-settings/set-socket-lock.md)
- [Get Plug & Charge Status](https://developer.plugchoice.com/api-reference/charger-settings/get-plug-charge.md)
- [Set Plug & Charge](https://developer.plugchoice.com/api-reference/charger-settings/set-plug-charge.md)
- [Get Public Charging Settings](https://developer.plugchoice.com/api-reference/charger-settings/get-public-charging.md)
- [Set Public Charging Settings](https://developer.plugchoice.com/api-reference/charger-settings/set-public-charging.md)
- [Get Display & LED Settings](https://developer.plugchoice.com/api-reference/charger-settings/get-display-led.md)
- [Set Display & LED Settings](https://developer.plugchoice.com/api-reference/charger-settings/set-display-led.md)
- [Get NANOGRID Configuration](https://developer.plugchoice.com/api-reference/charger-settings/get-nanogrid.md)
- [Set NANOGRID Configuration](https://developer.plugchoice.com/api-reference/charger-settings/set-nanogrid.md)
- [Remove NANOGRID Configuration](https://developer.plugchoice.com/api-reference/charger-settings/delete-nanogrid.md)
- [Update Connector](https://developer.plugchoice.com/api-reference/connectors/update-connector.md)
- [Get Power Usage](https://developer.plugchoice.com/api-reference/connectors/get-power-usage.md)
- [Get Latest Meter Value](https://developer.plugchoice.com/api-reference/connectors/get-latest-meter-value.md)
- [List Team Transactions](https://developer.plugchoice.com/api-reference/transactions/list-team-transactions.md)
- [List Transactions](https://developer.plugchoice.com/api-reference/transactions/list-charger-transactions.md)
- [List Transactions](https://developer.plugchoice.com/api-reference/transactions/list-site-transactions.md)
- [Import Transactions](https://developer.plugchoice.com/api-reference/transactions/import-charger-transactions.md)
- [List Meter Values](https://developer.plugchoice.com/api-reference/meter-values/list-charger-meter-values.md)
- [List Logs](https://developer.plugchoice.com/api-reference/ocpp-logs/list-charger-logs.md)
- [List Logbook Events](https://developer.plugchoice.com/api-reference/ocpp-logs/list-charger-events.md)
- [Energy Export](https://developer.plugchoice.com/api-reference/insights/energy-export.md)
- [List Tariffs](https://developer.plugchoice.com/api-reference/data/list-tariffs.md)
- [List Products](https://developer.plugchoice.com/api-reference/data/list-products.md)
- [List Providers](https://developer.plugchoice.com/api-reference/data/list-providers.md)
- [List Models](https://developer.plugchoice.com/api-reference/data/list-models.md)
- [List Meter Models](https://developer.plugchoice.com/api-reference/data/list-meter-models.md)
- [List Energy Suppliers](https://developer.plugchoice.com/api-reference/data/list-energy-suppliers.md)
- [Plugchoice SDK](https://developer.plugchoice.com/sdk/index.md): Let the people using your app connect their EV charger to Plugchoice, without leaving your app.
- [How Link works](https://developer.plugchoice.com/sdk/how-link-works.md): The few ideas behind the Plugchoice SDK, in plain words.
- [Get started](https://developer.plugchoice.com/sdk/get-started.md): Add a charger from your app: one endpoint on your server, a few lines in your app, and a check on your server afterwards.
- [Installation](https://developer.plugchoice.com/sdk/install.md): Add the Plugchoice SDK to your iOS, Android or React Native app.
- [iOS](https://developer.plugchoice.com/sdk/ios.md): Add the Plugchoice SDK to an iOS app, open Link and handle the result.
- [Android](https://developer.plugchoice.com/sdk/android.md): Add the Plugchoice SDK to an Android app, open Link and handle the result.
- [React Native](https://developer.plugchoice.com/sdk/react-native.md): Add the Plugchoice SDK to a React Native or Expo app, open Link and handle the result.
- [In a browser](https://developer.plugchoice.com/sdk/web.md): Open Link from a web page, without the mobile SDK.
- [Client sessions and scopes](https://developer.plugchoice.com/sdk/concepts/client-sessions.md): What your server creates for Link, what it may reach, and how the SDK gets it.
- [Actions](https://developer.plugchoice.com/sdk/concepts/actions.md): What your app opens Link for: add a charger, set it up, or reconnect it (which also changes its network).
- [Link sessions](https://developer.plugchoice.com/sdk/concepts/link-sessions.md): One time through Link: its status, its result in your app, and how your server confirms it.
- [Devices and capabilities](https://developer.plugchoice.com/sdk/concepts/capabilities.md): What Plugchoice can do for a charger, what a phone can do, and how to show a button only where it works.
- [Consent and branding](https://developer.plugchoice.com/sdk/concepts/consent-and-branding.md): What your users agree to, and how Link shows your name, logo and colour.
- [Test and live](https://developer.plugchoice.com/sdk/concepts/test-and-live.md): Build against test credentials with real chargers, then switch to live.
- [Supported chargers](https://developer.plugchoice.com/sdk/chargers/index.md): Which chargers Link can add, and what it can do for each one.
- [Alfen](https://developer.plugchoice.com/sdk/chargers/alfen.md): Add Alfen chargers from their flyer: Link finds the charger on the home network, or joins its setup hotspot, and configures it.
- [Easee](https://developer.plugchoice.com/sdk/chargers/easee.md): Add Easee chargers through Easee's cloud: the owner signs in, or confirms Plugchoice in the Easee app.
- [Peblar](https://developer.plugchoice.com/sdk/chargers/peblar.md): Add Peblar chargers from their card: the phone joins the charger's own hotspot and configures it.
- [Ratio](https://developer.plugchoice.com/sdk/chargers/ratio.md): Add Ratio io5 and io6 chargers picked from the ones nearby: the phone sets them up over Bluetooth.
- [SolarEdge](https://developer.plugchoice.com/sdk/chargers/solaredge.md): Add SolarEdge ONE EV Chargers from their sticker: the phone sets them up over Bluetooth.
- [Volt Time](https://developer.plugchoice.com/sdk/chargers/volt-time.md): Add Volt Time chargers with their serial number and pincode, give the One and Source 2s their Wi-Fi over Bluetooth, and set up the Source and Source 2 through their own web app.
- [Zaptec](https://developer.plugchoice.com/sdk/chargers/zaptec.md): Add Zaptec chargers by signing in to the owner's Zaptec account. Plugchoice switches the installation over.
- [Other OCPP chargers](https://developer.plugchoice.com/sdk/chargers/other.md): Add any OCPP 1.6 charger by hand: your user types its Chargepoint ID and points the charger at Plugchoice.
- [SDK API](https://developer.plugchoice.com/sdk/api/index.md): Create client sessions, read link sessions and read chargers from your server.
- [Create a client session](https://developer.plugchoice.com/sdk/api/create-client-session.md): Says who Link acts for, and what it may reach, for 60 minutes. Call it from the one endpoint your app's `fetchClientSecret` calls and return `client_secret` to the SDK, or send a browser to `web_url` (append `&action=…&charger_id=…` for an action other than `add`). Link opens any number of link sess…
- [Get a link session](https://developer.plugchoice.com/sdk/api/get-link-session.md): One time through Link, opened with one of your client sessions. The SDK returns its id (`sessionId`) when Link closes; read the outcome here before you rely on it (or poll it on a timer).
- [List chargers](https://developer.plugchoice.com/sdk/api/list-chargers.md): Newest first, with what each can do (`capabilities`): for an integration every charger at a site its team owns, whether Link added it or not; for a Plugchoice user the chargers at sites they have Sensitive access to. Filter by user (integrations) or site.
- [Get a charger](https://developer.plugchoice.com/sdk/api/get-charger.md): One of the chargers `listChargers` would list for you.
- [Errors](https://developer.plugchoice.com/sdk/errors/index.md): How the SDK API reports errors, every code you can meet, and the codes in your app's result.
- [bad-request](https://developer.plugchoice.com/sdk/errors/bad-request.md): The request can't be handled, for example because of the HTTP method.
- [charger-at-other-site](https://developer.plugchoice.com/sdk/errors/charger-at-other-site.md): The charger is at another site of the same account.
- [charger-offline](https://developer.plugchoice.com/sdk/errors/charger-offline.md): The charger has to be online to prove a claim by plugging in.
- [claim-closed](https://developer.plugchoice.com/sdk/errors/claim-closed.md): The claim is no longer open.
- [claim-exists](https://developer.plugchoice.com/sdk/errors/claim-exists.md): There is already an open claim on this charger.
- [client-session-expired](https://developer.plugchoice.com/sdk/errors/client-session-expired.md): The client secret is older than its 60 minutes.
- [consent-not-needed](https://developer.plugchoice.com/sdk/errors/consent-not-needed.md): This link session has no consent screen.
- [consent-required](https://developer.plugchoice.com/sdk/errors/consent-required.md): Your user's consent is needed before a charger is added.
- [forbidden](https://developer.plugchoice.com/sdk/errors/forbidden.md): The token is valid, but its client may not use the SDK API.
- [identity-busy](https://developer.plugchoice.com/sdk/errors/identity-busy.md): Someone registered this charger moments ago.
- [identity-not-taken](https://developer.plugchoice.com/sdk/errors/identity-not-taken.md): There's nothing to claim: the charger isn't someone else's.
- [identity-taken](https://developer.plugchoice.com/sdk/errors/identity-taken.md): The charger is already connected to another account.
- [location-already-set](https://developer.plugchoice.com/sdk/errors/location-already-set.md): The link session already has a site.
- [location-required](https://developer.plugchoice.com/sdk/errors/location-required.md): The new site's address is needed before a charger is added.
- [method-not-allowed](https://developer.plugchoice.com/sdk/errors/method-not-allowed.md): That brand, model and onboarding method are not offered in this link session.
- [not-found](https://developer.plugchoice.com/sdk/errors/not-found.md): The resource doesn't exist, or it isn't one you may use.
- [nothing-to-complete](https://developer.plugchoice.com/sdk/errors/nothing-to-complete.md): A link session can only complete once a charger is finished.
- [pincode-invalid](https://developer.plugchoice.com/sdk/errors/pincode-invalid.md): The charger's identity and pincode don't match.
- [plug-in-not-available](https://developer.plugchoice.com/sdk/errors/plug-in-not-available.md): Plugging in can't prove this claim.
- [rate-limited](https://developer.plugchoice.com/sdk/errors/rate-limited.md): Too many requests: wait, then try again.
- [scope-required](https://developer.plugchoice.com/sdk/errors/scope-required.md): A client session needs a scope.
- [server-error](https://developer.plugchoice.com/sdk/errors/server-error.md): Something went wrong on Plugchoice's side.
- [session-ended](https://developer.plugchoice.com/sdk/errors/session-ended.md): The link session is completed, abandoned or expired.
- [site-required](https://developer.plugchoice.com/sdk/errors/site-required.md): An add needs a site, because the client session reaches several.
- [unauthenticated](https://developer.plugchoice.com/sdk/errors/unauthenticated.md): The request has no valid credentials.
- [unknown-version](https://developer.plugchoice.com/sdk/errors/unknown-version.md): The Plugchoice-Version header names a version the SDK API doesn't know.
- [unsupported-device-type](https://developer.plugchoice.com/sdk/errors/unsupported-device-type.md): The client session asks for a device type the SDK API doesn't support yet.
- [validation-failed](https://developer.plugchoice.com/sdk/errors/validation-failed.md): The request body or query doesn't pass validation.
- [vendor-charger-offline](https://developer.plugchoice.com/sdk/errors/vendor-charger-offline.md): Zaptec reports the charger as offline.
- [vendor-error](https://developer.plugchoice.com/sdk/errors/vendor-error.md): The brand's cloud refused the request or answered something unexpected.
- [vendor-not-permitted](https://developer.plugchoice.com/sdk/errors/vendor-not-permitted.md): The brand's cloud doesn't let this account make the change.
- [vendor-rate-limited](https://developer.plugchoice.com/sdk/errors/vendor-rate-limited.md): The brand's cloud is busy.
- [vendor-sign-in-failed](https://developer.plugchoice.com/sdk/errors/vendor-sign-in-failed.md): The brand's cloud didn't accept the email address and password.
- [vendor-sign-in-required](https://developer.plugchoice.com/sdk/errors/vendor-sign-in-required.md): The sign-in to the brand's cloud expired, or was never made.
- [vendor-unavailable](https://developer.plugchoice.com/sdk/errors/vendor-unavailable.md): The brand's cloud couldn't be reached.
- [Security](https://developer.plugchoice.com/sdk/security.md): What the SDK can and can't do on your users' phones, how secrets travel, and what the hosted flow runs. For your security review.
- [Versions](https://developer.plugchoice.com/sdk/versioning.md): How the SDK, the hosted flow and the SDK API are versioned, and what to pin.
- [Changelog](https://developer.plugchoice.com/sdk/changelog.md): New versions of the Plugchoice SDK and the SDK API.

## OpenAPI Specs

- [sdk-v1.openapi](/api-reference/sdk/sdk-v1.openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.