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

# List Pool Transactions

> Retrieve historical movements in your pool, including deposits, payments (debits), and withdrawals.

### Headers

<ParamField header="x-api-key" type="string" required>
  Your test or live SDK API key (`pk_test_...` or `pk_live_...`).
</ParamField>

### Query Parameters

<ParamField query="type" type="string">
  Filter by movement type: `DEPOSIT`, `DEBIT` (payment), `CREDIT` (refund), `WITHDRAWAL`.
</ParamField>

<ParamField query="limit" type="number">
  Results per page (default `50`, max `100`).
</ParamField>

<ParamField query="offset" type="number">
  Number of results to skip (default `0`).
</ParamField>

### Response Fields

<ResponseField name="transactions" type="array">
  <Expandable title="Transaction Item">
    <ResponseField name="id" type="string">
      Internal transaction ID.
    </ResponseField>

    <ResponseField name="type" type="string">
      Type of movement (e.g., `DEBIT`).
    </ResponseField>

    <ResponseField name="amount" type="string">
      Amount changed (negative for debits/withdrawals).
    </ResponseField>

    <ResponseField name="balance_before" type="string">
      Pool balance before this transaction.
    </ResponseField>

    <ResponseField name="balance_after" type="string">
      Pool balance after this transaction.
    </ResponseField>

    <ResponseField name="status" type="string">
      Status: `PENDING` or `CONFIRMED`.
    </ResponseField>

    <ResponseField name="tx_hash" type="string">
      Blockchain transaction hash (if applicable).
    </ResponseField>

    <ResponseField name="description" type="string">
      Human-readable explanation.
    </ResponseField>

    <ResponseField name="payment" type="object">
      Reference to the associated payment (only for `DEBIT` and `CREDIT`).
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp.
    </ResponseField>

    <ResponseField name="confirmed_at" type="string">
      Time of transaction finality.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Pagination Details">
    <ResponseField name="total" type="number">
      Total count of matching records.
    </ResponseField>

    <ResponseField name="limit" type="number">
      Current requested page size limit.
    </ResponseField>

    <ResponseField name="offset" type="number">
      Current offset position.
    </ResponseField>

    <ResponseField name="has_more" type="boolean">
      Indicates if more records are available.
    </ResponseField>
  </Expandable>
</ResponseField>

### Response Example

```json theme={null}
{
  "transactions": [
    {
      "id": "ptx_abc123",
      "type": "DEBIT",
      "amount": "-15.00",
      "balance_before": "5000.00",
      "balance_after": "4985.00",
      "status": "CONFIRMED",
      "tx_hash": "0xabcd...",
      "description": "Payment for Merchant: Organic Coffee",
      "payment": {
        "payment_id": "pay_999",
        "amount": "15.00",
        "merchant_name": "Organic Coffee"
      },
      "created_at": "2026-03-31T01:50:00Z",
      "confirmed_at": "2026-03-31T01:50:05Z"
    }
  ],
  "pagination": {
    "total": 542,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}
```