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

# Energy Export

Exports energy usage data for a location at 15-minute intervals, including the location power curve and per-charger summary.

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

<ParamField query="started_from" type="string" required>
  The start date for the export range. Must be a valid date string (e.g., `2024-01-01`). Data is returned from the start of this day.
</ParamField>

<ParamField query="stopped_until" type="string" required>
  The end date for the export range. Must be a valid date string and equal to or after `started_from`. Data is returned through the end of this day.
</ParamField>

## Response

<ResponseField name="power_curve" type="array">
  The location-level power curve, sampled at 15-minute intervals from site statistics.

  <Expandable title="interval object">
    <ResponseField name="date" type="string">
      The timestamp marking the start of the 15-minute interval bucket.
    </ResponseField>

    <ResponseField name="avg_kw" type="number">
      The average power draw across the interval, in kilowatts (rounded to 2 decimals).
    </ResponseField>

    <ResponseField name="kwh" type="number">
      The energy delivered during the interval, in kilowatt-hours (rounded to 4 decimals).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="charger_summary" type="array">
  A per-charger energy summary derived from completed transactions, ordered by total energy delivered (descending).

  <Expandable title="charger object">
    <ResponseField name="charger_identity" type="string">
      The OCPP identity of the charger.
    </ResponseField>

    <ResponseField name="charger_reference" type="string">
      The viewing team's reference for the charger, or an empty string if none is set.
    </ResponseField>

    <ResponseField name="total_kwh" type="number">
      The total energy delivered by the charger over the range, in kilowatt-hours (rounded to 2 decimals).
    </ResponseField>

    <ResponseField name="transaction_count" type="integer">
      The number of completed transactions for the charger over the range.
    </ResponseField>
  </Expandable>
</ResponseField>
