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

Returns a paginated list of transactions across all chargers the team has sensitive access to. Uses cursor-based pagination (simple pagination) for infinite scroll support.

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

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

<ParamField query="filter[search]" type="string">
  Search by transaction ID (numeric), Card UID, or Chargepoint ID.
</ParamField>

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

<ParamField query="page" type="integer">
  Page number for pagination. 25 results per page.
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of transaction objects.

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

    <ResponseField name="status" type="string">
      The transaction status. One of `active` or `finished`.
    </ResponseField>

    <ResponseField name="charger" type="object">
      The charger associated with this transaction. May be `null`.

      <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="reference" type="string">
          The reference label of the charger. May be `null`.
        </ResponseField>

        <ResponseField name="site" type="object">
          The location the charger belongs to. May be `null`.

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

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

        <ResponseField name="is_mid" type="boolean">
          Whether the charger model is MID certified. May be `null` if unknown.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="connector_id" type="integer">
      The OCPP connector ID used for this transaction. May be `null`.
    </ResponseField>

    <ResponseField name="id_tag" type="string">
      The RFID tag or token used to authorize the transaction.
    </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. `null` for active transactions.
    </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. `null` for active transactions.
    </ResponseField>

    <ResponseField name="total_kwh" type="number">
      The total energy consumed in kWh, rounded to 2 decimal places.
    </ResponseField>

    <ResponseField name="stop_reason" type="string">
      The reason the transaction was stopped (e.g., `Local`, `Remote`, `EVDisconnected`). `null` for active transactions.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="filter_options" type="object">
  Available filter options.

  <Expandable title="filter_options">
    <ResponseField name="statuses" type="array">
      Available status filter values (`active`, `finished`).
    </ResponseField>
  </Expandable>
</ResponseField>