> ## Documentation Index
> Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugchoice API

> Build integrations with the Plugchoice EV charging management platform.

The Plugchoice API lets you manage EV chargers, sites, teams, and charging sessions programmatically. All endpoints are RESTful, accept JSON request bodies, and return JSON responses.

## Base URL

```
https://app.plugchoice.com/api/v3
```

## Authentication

All API requests require a bearer token in the `Authorization` header.

```bash theme={null}
curl https://app.plugchoice.com/api/v3/user \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

You can generate personal access tokens from your [dashboard settings](https://app.plugchoice.com/settings/personal-access-tokens), or use OAuth 2.0 for third-party integrations.

<Card title="Authentication guide" icon="lock" href="/guides/authentication">
  Learn about OAuth 2.0 flows, personal access tokens, and token management.
</Card>

## Resource hierarchy

Plugchoice resources are organized in a hierarchy:

* **Teams** are the top-level organizational unit. Users belong to one or more teams.
* **Locations** represent physical sites with chargers. Locations belong to teams.
* **Chargers** are individual charging stations. Chargers are assigned to locations.
* **Connectors** are the physical plugs on a charger. A charger can have one or more connectors.

## Quick links

<Columns cols={2}>
  <Card title="Authentication" icon="key" href="/guides/authentication">
    OAuth 2.0, personal access tokens, and bearer auth.
  </Card>

  <Card title="Chargers" icon="plug" href="/api-reference/chargers/list-chargers">
    Manage chargers, firmware, and settings.
  </Card>

  <Card title="Locations" icon="building" href="/api-reference/sites/list-sites">
    Create and manage charging locations.
  </Card>

  <Card title="Charger Actions" icon="bolt" href="/api-reference/charger-actions/start-charging">
    Start/stop charging, restart chargers, and more.
  </Card>
</Columns>