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

Returns a paginated list of all connectors across all chargers for the specified location. Each connector includes its parent charger information. Results are paginated with 25 items per page.

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

## Response

<ResponseField name="id" type="integer">
  The numeric ID of the connector.
</ResponseField>

<ResponseField name="charger_id" type="integer">
  The ID of the parent charger.
</ResponseField>

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

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

<ResponseField name="error" type="string">
  The current error code, if any.
</ResponseField>

<ResponseField name="error_info" type="string">
  Additional error information, if any.
</ResponseField>

<ResponseField name="vendor_id" type="string">
  The vendor identifier.
</ResponseField>

<ResponseField name="vendor_error_code" type="string">
  The vendor-specific error code, if any.
</ResponseField>

<ResponseField name="max_amperage" type="integer">
  The maximum amperage of the connector.
</ResponseField>

<ResponseField name="min_current" type="integer">
  The minimum current of the connector.
</ResponseField>

<ResponseField name="current_limit" type="integer">
  The current limit of the connector.
</ResponseField>

<ResponseField name="current_limit_managed_by" type="string">
  Identifies what is currently managing the connector's current limit. May be `null`.
</ResponseField>

<ResponseField name="max_voltage" type="integer">
  The maximum voltage of the connector.
</ResponseField>

<ResponseField name="standard" type="string">
  The connector standard (e.g., IEC 62196).
</ResponseField>

<ResponseField name="format" type="string">
  The connector format (e.g., Socket, Cable).
</ResponseField>

<ResponseField name="power_type" type="string">
  The power type (e.g., AC\_1\_PHASE, AC\_3\_PHASE, DC).
</ResponseField>

<ResponseField name="phase_rotation" type="string">
  The phase rotation configuration.
</ResponseField>

<ResponseField name="charger" type="object">
  The parent charger object.

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

    <ResponseField name="id" type="integer">
      The numeric ID of the charger.
    </ResponseField>

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

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

    <ResponseField name="pincode" type="string">
      The charger's pincode. Only included when the authenticated user has permission to view sensitive data.
    </ResponseField>

    <ResponseField name="reference" type="string">
      A custom reference label for the charger, or `null` if none is set.
    </ResponseField>

    <ResponseField name="connection_status" type="string">
      The current connection status of the charger.
    </ResponseField>

    <ResponseField name="status" type="string">
      The current OCPP status of the charger.
    </ResponseField>

    <ResponseField name="error" type="string">
      The current error code, if any.
    </ResponseField>

    <ResponseField name="error_info" type="string">
      Additional error information, if any.
    </ResponseField>

    <ResponseField name="vendor_id" type="string">
      The vendor identifier.
    </ResponseField>

    <ResponseField name="vendor_error_code" type="string">
      The vendor-specific error code, if any.
    </ResponseField>

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

    <ResponseField name="parsed_firmware_version" type="string">
      The parsed firmware version, or `null` if unparseable.
    </ResponseField>

    <ResponseField name="server" type="string">
      The OCPP server the charger is connected to.
    </ResponseField>

    <ResponseField name="last_connection_at" type="string">
      ISO 8601 timestamp of the last connection.
    </ResponseField>

    <ResponseField name="last_disconnection_at" type="string">
      ISO 8601 timestamp of the last disconnection.
    </ResponseField>

    <ResponseField name="last_heartbeat_at" type="string">
      ISO 8601 timestamp of the last heartbeat.
    </ResponseField>

    <ResponseField name="setup_pending" type="boolean">
      Whether the charger has a pending setup.
    </ResponseField>

    <ResponseField name="setup_completed" type="boolean">
      Whether the charger setup is completed.
    </ResponseField>

    <ResponseField name="blocked" type="boolean">
      Whether the charger is blocked.
    </ResponseField>

    <ResponseField name="max_current" type="integer">
      The maximum current in amps.
    </ResponseField>

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

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of when the charger was last updated.
    </ResponseField>

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

      <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_id" type="integer">
      The ID of the charger's model.
    </ResponseField>

    <ResponseField name="is_mid" type="boolean">
      Whether the charger is a MID-certified (metering compliant) model.
    </ResponseField>

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

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

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp of when the connector was last updated.
</ResponseField>