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

# Transactions and events

> List payment transactions and analytics events from the Proceeds CLI.

After agents pay, use the CLI to list transactions and request events. Both resources are **read-only** lists with pagination. Add `--format json` for machine-readable output.

<Note>
  Transaction `amount` values are USDC **base-unit strings** (`1000000` = `$1.00`, `10000` = `$0.01`, `250000` = `$0.25`).
</Note>

## Transactions

```bash theme={null}
proceeds transactions list --limit 1 --format json
proceeds transactions list --status COMPLETED --paywall-id <paywallId>
```

| Flag           | Notes                               |
| -------------- | ----------------------------------- |
| `--limit`      | Page size (1–100), default `20`     |
| `--offset`     | Records to skip, default `0`        |
| `--status`     | `PENDING`, `COMPLETED`, or `FAILED` |
| `--paywall-id` | Filter by paywall                   |

Example response:

```json theme={null}
{
  "data": [
    {
      "id": "xuw…",
      "paywallId": "g2tw…",
      "amount": "250000",
      "currency": "USDC",
      "network": "tempo",
      "status": "COMPLETED",
      "scheme": "mpp",
      "txHash": "0x…",
      "Paywall": {
        "slug": "generate-4s",
        "name": "Generate 4s clip",
        "price": "250000"
      }
    }
  ],
  "meta": {
    "pagination": { "total": 649, "limit": 1, "offset": 0, "hasMore": true }
  }
}
```

## Events

```bash theme={null}
proceeds events list --limit 1 --format json
proceeds events list --event-type SUCCESS --paywall-id <paywallId>
```

| Flag           | Notes                            |
| -------------- | -------------------------------- |
| `--limit`      | Page size (1–100), default `20`  |
| `--offset`     | Records to skip, default `0`     |
| `--event-type` | `REQUEST`, `SUCCESS`, or `ERROR` |
| `--paywall-id` | Filter by paywall                |

Example response (includes `meta.stats`):

```json theme={null}
{
  "data": [
    {
      "id": "nhgo…",
      "paywallId": "vrxf…",
      "eventType": "REQUEST",
      "metadata": { "slug": "cli-docs-get", "protocol": "mpp" },
      "Paywall": { "slug": "cli-docs-get", "name": "CLI docs GET demo" }
    }
  ],
  "meta": {
    "pagination": { "total": 11180, "limit": 1, "offset": 0, "hasMore": true },
    "stats": [
      { "eventType": "ERROR", "count": 3001 },
      { "eventType": "REQUEST", "count": 7530 },
      { "eventType": "SUCCESS", "count": 649 }
    ]
  }
}
```

## Related

<CardGroup cols={2}>
  <Card title="Paywalls" icon="lock" href="/cli/paywalls">
    Manage priced routes.
  </Card>

  <Card title="Services" icon="server" href="/cli/services">
    Manage upstream wrappers.
  </Card>
</CardGroup>