List Locations

GET /v3/teams/{team}/sites

List Locations

cURL

curl --request GET \
  --url https://app.plugchoice.com/api/v3/teams/{team}/sites \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "uuid": "<string>",
      "name": "<string>",
      "address": "<string>",
      "street": "<string>",
      "postal_code": "<string>",
      "house_number": 123,
      "house_number_addition": "<string>",
      "city": "<string>",
      "country": "<string>",
      "smart_charging": "<string>",
      "chargers_count": 123,
      "created_at": "<string>"
    }
  ],
  "filter_options": {
    "countries": [
      {}
    ],
    "smart_charging_modes": [
      {}
    ]
  }
}

Returns a paginated list of locations belonging to the specified team, with filtering and sorting support.

team · string · required

The UUID of the team.

filter[search] · string

Filter by location name or address.

filter[country] · string

Filter by ISO 3166-1 alpha-2 country code (e.g., NL, DE, BE).

filter[smart_charging] · string

Filter by smart charging mode. One of disabled, day_ahead_pricing, or off_peak.

sort · string

Sort field. One of name, country, chargers_count, or created_at. Prefix with - for descending order. Defaults to name.

page · integer

Page number for pagination.

Response

data · array

Array of location objects.

Show site

uuid · string

The unique UUID of the location.

name · string

The location name.

address · string

The full formatted address.

street · string

The street name.

postal_code · string

The postal code.

house_number · integer

The house number.

house_number_addition · string

The house number addition (e.g., “A”, “B”). May be null.

city · string

The city name.

country · string

The ISO 3166-1 alpha-2 country code.

smart_charging · string

The smart charging mode (disabled, day_ahead_pricing, or off_peak).

chargers_count · integer

The number of chargers at this location.

created_at · string

ISO 8601 timestamp of when the location was created.

filter_options · object

Available filter options based on the current dataset.

Show filter_options

countries · array

Available country codes.

smart_charging_modes · array

Available smart charging mode values.