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

> List transactions for a specific card

Lists the transactions on one card, with amount, merchant, status, and timestamps. Use `limit` and `status` to narrow the results, or `list_all_transactions` for the account-wide view.

## Parameters

| Parameter | Type   | Required | Description                                                                                |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------ |
| `card_id` | string | Yes      | The card ID                                                                                |
| `limit`   | number | No       | Max number of transactions to return (default 20)                                          |
| `status`  | string | No       | Filter by transaction status, e.g. PENDING, SETTLED, DECLINED, REVERSED, EXPIRED, REFUNDED |

## Returns

The card's transactions newest first, each with ID, amount in cents, merchant, description, status, event type, merchant category code, and created timestamp, plus a `count`. When there is nothing to show, you get "No transactions found."

## Example

```json theme={null}
{ "name": "list_transactions", "arguments": { "card_id": "card_abc123" } }
```
