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

Returns a paginated list of chargers 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 charger identity, serial number, or team reference.
</ParamField>

<ParamField query="filter[connection_status]" type="string">
  Filter by connection status. One of `online`, `offline`, or `never_seen`.
</ParamField>

<ParamField query="filter[status]" type="string">
  Filter by charger status. One of `Available`, `Charging`, `Faulted`, `Finishing`, `Preparing`, `Reserved`, `SuspendedEV`, `SuspendedEVSE`, or `Unavailable`.
</ParamField>

<ParamField query="filter[connector_status]" type="string">
  Filter by connector status. One of `Available`, `Charging`, `Faulted`, `Finishing`, `Preparing`, `Reserved`, `SuspendedEV`, `SuspendedEVSE`, or `Unavailable`. Accepts a single value or an array.
</ParamField>

<ParamField query="filter[vendor]" type="string">
  Filter by charger vendor. Accepts a single value or an array.
</ParamField>

<ParamField query="filter[model]" type="string">
  Filter by charger model name. Accepts a single value or an array.
</ParamField>

<ParamField query="filter[firmware_version]" type="string">
  Filter by firmware version. Matches partially.
</ParamField>

<ParamField query="filter[license]" type="string">
  Filter by license type. One of `basic`, `smart`, or `pro`. Accepts a single value or an array.
</ParamField>

<ParamField query="filter[site_uuid]" type="string">
  Filter by location UUID. Accepts a single value or an array.
</ParamField>

<ParamField query="sort" type="string">
  Sort field. One of `identity`, `connection_status`, `status`, `created_at`, `firmware_version`, or `model`. 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 charger objects.

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

    <ResponseField name="identity" type="string">
      The charger's identity string.
    </ResponseField>

    <ResponseField name="serial_number" type="string">
      The charger's serial number. May be `null`.
    </ResponseField>

    <ResponseField name="reference" type="string">
      The team's reference for this charger. May be `null`.
    </ResponseField>

    <ResponseField name="connection_status" type="string">
      The connection status (`online`, `offline`, or `never_seen`).
    </ResponseField>

    <ResponseField name="status" type="string">
      The charger status. One of `Available`, `Charging`, `Faulted`, `Finishing`, `Preparing`, `Reserved`, `SuspendedEV`, `SuspendedEVSE`, or `Unavailable`.
    </ResponseField>

    <ResponseField name="firmware_version" type="string">
      The charger's firmware version. May be `null`.
    </ResponseField>

    <ResponseField name="licenses" type="object">
      License status for the charger.

      <Expandable title="licenses">
        <ResponseField name="smart" type="boolean">
          Whether the smart license is active.
        </ResponseField>

        <ResponseField name="pro" type="boolean">
          Whether the pro license is active.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="model" type="object">
      The charger model information.

      <Expandable title="model">
        <ResponseField name="vendor" type="string">
          The charger vendor name.
        </ResponseField>

        <ResponseField name="name" type="string">
          The charger model name.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="internal_model" type="object">
      Internal model details.

      <Expandable title="internal_model">
        <ResponseField name="name" type="string">
          The internal model name.
        </ResponseField>

        <ResponseField name="sku" type="string">
          The internal model SKU.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="site" type="object">
      The location assigned to this charger.

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

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

    <ResponseField name="connectors" type="object">
      The charger's connectors.

      <Expandable title="connectors">
        <ResponseField name="data" type="array">
          Array of connector objects.

          <Expandable title="connector">
            <ResponseField name="id" type="integer">
              The connector ID.
            </ResponseField>

            <ResponseField name="connector_id" type="integer">
              The OCPP connector ID.
            </ResponseField>

            <ResponseField name="status" type="string">
              The connector status.
            </ResponseField>

            <ResponseField name="error" type="string">
              The connector error code, if any. May be `null`.
            </ResponseField>

            <ResponseField name="error_info" type="string">
              Additional information about the connector error. May be `null`.
            </ResponseField>

            <ResponseField name="vendor_id" type="string">
              The vendor identifier reported for the connector. May be `null`.
            </ResponseField>

            <ResponseField name="vendor_error_code" type="string">
              The vendor-specific error code for the connector. May be `null`.
            </ResponseField>
          </Expandable>
        </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="connection_statuses" type="array">
      Available connection status values.
    </ResponseField>

    <ResponseField name="statuses" type="array">
      Available charger status values.
    </ResponseField>

    <ResponseField name="connector_statuses" type="array">
      Available connector status values.
    </ResponseField>

    <ResponseField name="vendors" type="array">
      Available vendor names.
    </ResponseField>

    <ResponseField name="models" type="array">
      Available model names.
    </ResponseField>

    <ResponseField name="sites" type="array">
      Available locations, each as an object with `value` (location UUID) and `label` (location name).
    </ResponseField>

    <ResponseField name="license_types" type="array">
      Available license type values (`basic`, `smart`, `pro`).
    </ResponseField>
  </Expandable>
</ResponseField>