> ## 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.

# List Locations

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

<ParamField path="team" type="string" required>
  The UUID of the team.
</ParamField>

<ParamField query="filter[search]" type="string">
  Filter by location name or address.
</ParamField>

<ParamField query="filter[country]" type="string">
  Filter by ISO 3166-1 alpha-2 country code (e.g., `NL`, `DE`, `BE`).
</ParamField>

<ParamField query="filter[smart_charging]" type="string">
  Filter by smart charging mode. One of `disabled`, `day_ahead_pricing`, or `off_peak`.
</ParamField>

<ParamField query="sort" type="string">
  Sort field. One of `name`, `country`, `chargers_count`, or `created_at`. Prefix with `-` for descending order. Defaults to `-created_at`.
</ParamField>

<ParamField query="page" type="integer">
  Page number for pagination.
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of location objects.

  <Expandable title="site">
    <ResponseField name="uuid" type="string">
      The unique UUID of the location.
    </ResponseField>

    <ResponseField name="name" type="string">
      The location name.
    </ResponseField>

    <ResponseField name="address" type="string">
      The full formatted address.
    </ResponseField>

    <ResponseField name="street" type="string">
      The street name.
    </ResponseField>

    <ResponseField name="postal_code" type="string">
      The postal code.
    </ResponseField>

    <ResponseField name="house_number" type="integer">
      The house number.
    </ResponseField>

    <ResponseField name="house_number_addition" type="string">
      The house number addition (e.g., "A", "B"). May be `null`.
    </ResponseField>

    <ResponseField name="city" type="string">
      The city name.
    </ResponseField>

    <ResponseField name="country" type="string">
      The ISO 3166-1 alpha-2 country code.
    </ResponseField>

    <ResponseField name="latitude" type="number">
      The latitude coordinate of the location. May be `null`.
    </ResponseField>

    <ResponseField name="longitude" type="number">
      The longitude coordinate of the location. May be `null`.
    </ResponseField>

    <ResponseField name="manual_coordinates" type="boolean">
      Whether the coordinates were set manually rather than geocoded.
    </ResponseField>

    <ResponseField name="smart_charging" type="string">
      The smart charging mode (`disabled`, `day_ahead_pricing`, or `off_peak`).
    </ResponseField>

    <ResponseField name="chargers_count" type="integer">
      The number of chargers at this location.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the location was created.
    </ResponseField>

    <ResponseField name="permissions" type="object">
      The authenticated user's permissions for this location.

      <Expandable title="permissions">
        <ResponseField name="basic" type="boolean">
          Whether the user has basic access to the location.
        </ResponseField>

        <ResponseField name="sensitive" type="boolean">
          Whether the user has access to sensitive location data.
        </ResponseField>

        <ResponseField name="full" type="boolean">
          Whether the user has full access to the location.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="filter_options" type="object">
  Available filter options based on the current dataset.

  <Expandable title="filter_options">
    <ResponseField name="countries" type="array">
      Available country codes.
    </ResponseField>

    <ResponseField name="smart_charging_modes" type="array">
      Available smart charging mode values.
    </ResponseField>
  </Expandable>
</ResponseField>