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

# Get Power Management

Returns the power management status for the specified location, including the hierarchical group structure, chargers, connectors, and real-time metrics for load management visualization.

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

## Response

<ResponseField name="data" type="object">
  The power management payload.

  <Expandable title="data">
    <ResponseField name="groups" type="array">
      An array of top-level load balancing group objects.

      <Expandable title="group object">
        <ResponseField name="id" type="integer">
          The numeric ID of the group.
        </ResponseField>

        <ResponseField name="isRoot" type="boolean">
          Whether this is a root-level group.
        </ResponseField>

        <ResponseField name="totalAmps" type="integer">
          The total available amperage for the group.
        </ResponseField>

        <ResponseField name="netType" type="string">
          The electrical network type (e.g., `TT`, `TN`, `IT`).
        </ResponseField>

        <ResponseField name="method" type="string">
          The load balancing method.
        </ResponseField>

        <ResponseField name="peakShaving" type="object">
          Peak shaving configuration.

          <Expandable title="peakShaving">
            <ResponseField name="enabled" type="boolean">
              Whether peak shaving is enabled.
            </ResponseField>

            <ResponseField name="threshold" type="integer">
              The peak shaving threshold in amps.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="meter" type="object">
          The attached meter, or `null` if none.

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

            <ResponseField name="uuid" type="string">
              The UUID of the meter.
            </ResponseField>

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

            <ResponseField name="serialNumber" type="string">
              The serial number of the meter.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="solarSettings" type="object">
          Solar integration settings.

          <Expandable title="solarSettings">
            <ResponseField name="additionalAmps" type="integer">
              Additional amperage from solar.
            </ResponseField>

            <ResponseField name="alwaysCharge" type="boolean">
              Whether to always charge when solar is available.
            </ResponseField>

            <ResponseField name="alwaysChargeAmps" type="integer">
              Minimum amperage when solar always charge is enabled.
            </ResponseField>

            <ResponseField name="smartChargingChargeOnSolarExport" type="boolean">
              Whether to charge on solar export.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="dataKeys" type="object">
          A map of Redis key names for the group's real-time available, requested, and allocated amperage per phase, plus the `meter` key (or `null` when no meter is attached).
        </ResponseField>

        <ResponseField name="chargers" type="array">
          An array of charger objects assigned to this group. Each charger has the same structure as the entries in `unattachedChargers`.
        </ResponseField>

        <ResponseField name="subgroups" type="array">
          An array of nested subgroup objects (same structure as group).
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unattachedChargers" type="array">
      An array of chargers not assigned to any group.

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

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

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

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

        <ResponseField name="maxCurrent" type="integer">
          The maximum current of the charger.
        </ResponseField>

        <ResponseField name="hasSmartLicense" type="boolean">
          Whether the charger has a smart charging license.
        </ResponseField>

        <ResponseField name="connectors" type="array">
          An array of connector objects for this charger.

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

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

            <ResponseField name="connectorId" type="integer">
              The OCPP connector ID on the charger.
            </ResponseField>

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

            <ResponseField name="phaseRotation" type="string">
              The phase rotation (e.g., `RST`).
            </ResponseField>

            <ResponseField name="maxAmperage" type="integer">
              The maximum amperage for the connector.
            </ResponseField>

            <ResponseField name="minCurrent" type="integer">
              The minimum current for the connector.
            </ResponseField>

            <ResponseField name="currentLimit" type="integer">
              The configured current limit, or `null`.
            </ResponseField>

            <ResponseField name="currentLimitManagedBy" type="string">
              What set the current limit. One of `api` or `user`, or `null` when not set.
            </ResponseField>

            <ResponseField name="powerType" type="string">
              The power type of the connector, or `null`.
            </ResponseField>

            <ResponseField name="standard" type="string">
              The connector standard, or `null`.
            </ResponseField>

            <ResponseField name="format" type="string">
              The connector format, or `null`.
            </ResponseField>

            <ResponseField name="maxVoltage" type="integer">
              The maximum voltage for the connector, or `null`.
            </ResponseField>

            <ResponseField name="dataKeys" type="object">
              A map of Redis key names for the connector's real-time requested/allocated amperage per phase and power usage.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="allChargers" type="array">
      A flat array of all location chargers with group assignment info.

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

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

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

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

        <ResponseField name="groupId" type="integer">
          The ID of the group the charger is assigned to, or `null`.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="realTimeData" type="object">
      A map of data keys to their current values for real-time load management metrics (available, requested, and allocated amperage per phase).
    </ResponseField>

    <ResponseField name="meterData" type="object">
      A map of meter IDs to their current power readings.
    </ResponseField>
  </Expandable>
</ResponseField>