> ## 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 across the whole account GROUPED by payment method: wallet (USDC collateral) card spend, legacy saved-card-on-file spend, sandbox/test card s…

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

**Behavior:** read-only, idempotent.

<Note>Not in the default `tools/list`. It is still callable by exact name, and appears when the client sends the `x-expert-tools: 1` header.</Note>

## What it does

List transactions across the whole account GROUPED by payment method: wallet (USDC collateral) card spend, legacy saved-card-on-file spend, sandbox/test card spend, and wallet-funding deposits grouped by Apple Pay / Google Pay. Each group carries all-time totals; each transaction row carries its card (id + last4), merchant name + MCC, and — for purchases made through the buy flow — the merchant order behind the charge (merchant, order id, order total). Use this for "what did I spend, and how did I pay" style questions; use list\_all\_transactions for a flat ungrouped list, or buy\_order\_history for line-level items of a specific merchant's orders. limit/offset paginate the underlying newest-first transaction stream (groups repeat across pages); status filters card spend (e.g. SETTLED, DECLINED).

## Inputs

| Field    | Type   | Description                                                                                                                                                 |
| -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`  | number | Max number of transactions across all groups per page (default 50, max 100)                                                                                 |
| `offset` | number | Number of transactions to skip, for pagination (default 0)                                                                                                  |
| `status` | string | Filter card spend by transaction status (e.g. PENDING, SETTLED, DECLINED, REVERSED, EXPIRED, REFUNDED). Wallet-funding deposit groups are omitted when set. |

## Returns

| Field                  | Type   | Description                                                      |
| ---------------------- | ------ | ---------------------------------------------------------------- |
| `message` *(required)* | string | Human-readable report of transactions grouped by payment method. |
| `groupCount`           | number | Number of payment-method groups returned.                        |
| `returned`             | number | Number of transactions returned in this page across all groups.  |
| `groups`               | array  | One entry per payment method that has activity.                  |

## Example call

```json theme={null}
{
  "tool": "list_transactions_by_payment_method",
  "arguments": {}
}
```