Skip to main content
GET
/
api
/
v3
/
teams
/
{team_uuid}
/
chargers
List chargers
curl --request GET \
  --url https://app.plugchoice.com/api/v3/teams/{team_uuid}/chargers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "identity": "CHARGER-001",
      "connection_status": "online",
      "status": "Available",
      "licenses": {
        "smart": false,
        "pro": true
      },
      "model": {
        "vendor": "ABB",
        "name": "Terra AC"
      },
      "internal_model": {
        "name": "Terra AC W22",
        "sku": "TAC-W22"
      },
      "site": {
        "uuid": "660e8400-e29b-41d4-a716-446655440001",
        "name": "Main Office"
      },
      "connectors": {
        "data": [
          {
            "id": 1,
            "connector_id": 1,
            "status": "Available"
          }
        ]
      }
    }
  ],
  "first_page_url": "https://app.plugchoice.com/api/v3/teams/123/chargers?page=1",
  "from": 1,
  "next_page_url": "https://app.plugchoice.com/api/v3/teams/123/chargers?page=2",
  "path": "https://app.plugchoice.com/api/v3/teams/123/chargers",
  "per_page": 25,
  "prev_page_url": null,
  "to": 25,
  "filter_options": {
    "connection_statuses": [
      "online",
      "offline",
      "never_seen"
    ],
    "statuses": [
      "Available",
      "Faulted",
      "Unavailable"
    ],
    "connector_statuses": [
      "Available",
      "Charging",
      "Faulted",
      "Finishing",
      "Preparing",
      "Reserved",
      "SuspendedEV",
      "SuspendedEVSE",
      "Unavailable"
    ],
    "vendors": [
      "ABB",
      "Alfen",
      "Wallbox"
    ],
    "license_types": [
      "basic",
      "smart",
      "pro"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

See the documentation for more information.

Path Parameters

​
team_uuid
string
required

Query Parameters

​
filter[search]
string

Filter by charger identity

Example:

"CHARGER-001"

​
filter[connection_status]
string

Filter by connection status (online, offline, never_seen)

Example:

"online"

​
filter[status]
string

Filter by charger status (Available, Faulted, Unavailable)

Example:

"Available"

​
filter[connector_status]
string

Filter by connector status (Available, Charging, etc.)

Example:

"Available"

​
filter[vendor]
string

Filter by charger vendor

Example:

"ABB"

​
filter[license]
string

Filter by license type (basic, smart, pro)

Example:

"pro"

​
filter[site_uuid]
string

Filter by site UUID

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
sort
string

Sort field (identity, connection_status, status, created_at). Prefix with - for descending. Default: -created_at

Example:

"-created_at"

​
page
integer

Page number for pagination

Example:

1

Response

Paginated list of chargers with filter options

​
data
object[]
Example:
[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "identity": "CHARGER-001",
    "connection_status": "online",
    "status": "Available",
    "licenses": { "smart": false, "pro": true },
    "model": { "vendor": "ABB", "name": "Terra AC" },
    "internal_model": { "name": "Terra AC W22", "sku": "TAC-W22" },
    "site": {
      "uuid": "660e8400-e29b-41d4-a716-446655440001",
      "name": "Main Office"
    },
    "connectors": {
      "data": [
        {
          "id": 1,
          "connector_id": 1,
          "status": "Available"
        }
      ]
    }
  }
]
​
first_page_url
string
Example:

"https://app.plugchoice.com/api/v3/teams/123/chargers?page=1"

​
from
integer
Example:

1

​
next_page_url
string
Example:

"https://app.plugchoice.com/api/v3/teams/123/chargers?page=2"

​
path
string
Example:

"https://app.plugchoice.com/api/v3/teams/123/chargers"

​
per_page
integer
Example:

25

​
prev_page_url
string
Example:

null

​
to
integer
Example:

25

​
filter_options
object