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

Returns a paginated list of transactions for all chargers at a specific location. Includes the total energy consumption across the location.

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

<ParamField query="limit" type="integer">
  Maximum number of transactions to return. Between 1 and 10,000.
</ParamField>

<ParamField query="filter[status]" type="string">
  Filter by transaction status. One of `active` or `finished`.
</ParamField>

<ParamField query="filter[charger_uuid]" type="string">
  Filter by a specific charger UUID.
</ParamField>

<ParamField query="filter[started_from]" type="string">
  Filter transactions started from this date. ISO 8601 date format.
</ParamField>

<ParamField query="filter[stopped_until]" type="string">
  Filter transactions stopped until this date. Must be after or equal to `filter[started_from]`. ISO 8601 date format.
</ParamField>

<ParamField query="filter[id_tag]" type="string">
  Filter by exact RFID tag or token. Maximum 20 characters.
</ParamField>

<ParamField query="sort" type="string">
  Sort field. One of `created_at`, `started_at`, `stopped_at`, `total_kwh`, `meter_start`, or `meter_stop`. Prefix with `-` for descending order. Defaults to `-started_at`.
</ParamField>

## Response

<ResponseField name="id" type="integer">
  The transaction ID.
</ResponseField>

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

<ResponseField name="charger_connector_id" type="integer">
  The ID of the connector used.
</ResponseField>

<ResponseField name="reservation_id" type="integer">
  The reservation ID, if applicable. May be `null`.
</ResponseField>

<ResponseField name="id_tag" type="string">
  The RFID tag or token used to authorize the transaction.
</ResponseField>

<ResponseField name="meter_start" type="integer">
  The meter reading at the start of the transaction in Wh.
</ResponseField>

<ResponseField name="meter_stop" type="integer">
  The meter reading at the end of the transaction in Wh. May be `null` for active transactions.
</ResponseField>

<ResponseField name="total_kwh" type="number">
  The total energy consumed in kWh.
</ResponseField>

<ResponseField name="started_at" type="string">
  ISO 8601 timestamp of when the transaction started.
</ResponseField>

<ResponseField name="stopped_at" type="string">
  ISO 8601 timestamp of when the transaction stopped. May be `null` for active transactions.
</ResponseField>

<ResponseField name="stop_reason" type="string">
  The reason the transaction was stopped. May be `null`.
</ResponseField>

<ResponseField name="is_valid" type="boolean">
  Whether the transaction is considered valid. May be `null` if not yet determined.
</ResponseField>

<ResponseField name="charger" type="object">
  The charger associated with this transaction.

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

    <ResponseField name="identity" type="string">
      The Chargepoint ID of the charger.
    </ResponseField>

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

    <ResponseField name="reference" type="string">
      The reference label of the charger. May be `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="connector" type="object">
  The connector used for this transaction.

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

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

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

The response includes an additional top-level field:

<ResponseField name="total_kwh" type="number">
  The total energy consumption in kWh across all chargers at the location.
</ResponseField>