Skip to main content
GET
/
v3
/
teams
/
{team}
/
chargers
List Chargers
curl --request GET \
  --url https://app.plugchoice.com/api/v3/teams/{team}/chargers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "uuid": "<string>",
      "identity": "<string>",
      "connection_status": "<string>",
      "status": "<string>",
      "licenses": {
        "smart": true,
        "pro": true
      },
      "model": {
        "vendor": "<string>",
        "name": "<string>"
      },
      "internal_model": {
        "name": "<string>",
        "sku": "<string>"
      },
      "site": {
        "uuid": "<string>",
        "name": "<string>"
      },
      "connectors": {
        "data": [
          {
            "id": 123,
            "connector_id": 123,
            "status": "<string>"
          }
        ]
      }
    }
  ],
  "filter_options": {
    "connection_statuses": [
      {}
    ],
    "statuses": [
      {}
    ],
    "connector_statuses": [
      {}
    ],
    "vendors": [
      {}
    ],
    "license_types": [
      {}
    ]
  }
}
Returns a paginated list of chargers belonging to the specified team, with filtering and sorting support.
team
string
required
The UUID of the team.
Filter by charger identity.
filter[connection_status]
string
Filter by connection status. One of online, offline, or never_seen.
filter[status]
string
Filter by charger status. One of Available, Faulted, or Unavailable.
filter[connector_status]
string
Filter by connector status (e.g., Available, Charging, Faulted, Finishing, Preparing, Reserved, SuspendedEV, SuspendedEVSE, Unavailable).
filter[vendor]
string
Filter by charger vendor.
filter[license]
string
Filter by license type. One of basic, smart, or pro.
filter[site_uuid]
string
Filter by location UUID.
sort
string
Sort field. One of identity, connection_status, status, or created_at. Prefix with - for descending order. Defaults to -created_at.
page
integer
Page number for pagination.

Response

data
array
Array of charger objects.
filter_options
object
Available filter options based on the current dataset.