> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# list_transactions_by_payment_method

> List transactions grouped by payment method, with merchant and order info

Lists transactions across the whole account grouped by the payment method that moved the money: wallet (USDC collateral) card spend, legacy saved-card spend, sandbox/test card spend, and wallet-funding deposits grouped by Apple Pay / Google Pay. Each group carries all-time totals; each transaction carries its card (id + last4), merchant name + MCC, and — for purchases made through the `buy` flow — the merchant order behind the charge. Use `list_all_transactions` for a flat ungrouped list.

## Parameters

| Parameter | Type   | Required | Description                                                                                                   |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------- |
| `limit`   | number | No       | Max number of transactions across all groups per page (default 50, max 100)                                   |
| `offset`  | number | No       | Number of transactions to skip, for pagination (default 0, max 10000)                                         |
| `status`  | string | No       | Filter card spend by transaction status, e.g. PENDING, SETTLED, DECLINED. Deposit groups are omitted when set |

## Returns

A `groups` array — one entry per payment method with activity — each with `kind` (`wallet`, `stored_payment_method`, `sandbox`, or `wallet_funding`), a display `label`, `direction` (`spend` or `deposit`), all-time `transactionCount` and `totalCents` (real money movement only; declined/failed rows are listed but not counted), and the page's `transactions`. Spend rows include `cardId`/`cardLast4`, `merchant`, `mcc`, and an `order` object (merchant slug, order id, totals) when the card was minted by the buy flow. Deposit rows include `usdcAmount` and `paymentMethod`.

## Example

```json theme={null}
{ "name": "list_transactions_by_payment_method", "arguments": { "limit": 50 } }
```