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

# List Transactions

> List confirmed transactions with filtering and pagination

# List Transactions

Returns a paginated list of confirmed transactions for a merchant. Includes on-chain data, fee breakdowns, and settlement status.

## Query Parameters

<ParamField query="merchant_id" type="string" required>
  Filter by merchant ID.
</ParamField>

<ParamField query="status" type="string">
  Filter by status. One of: `confirmed`, `settled`, `failed`.
</ParamField>

<ParamField query="date_from" type="string">
  ISO 8601 timestamp. Only return transactions confirmed after this time.
</ParamField>

<ParamField query="date_to" type="string">
  ISO 8601 timestamp. Only return transactions confirmed before this time.
</ParamField>

<ParamField query="limit" type="integer">
  Number of results per page. Default: 25. Max: 100.
</ParamField>

<ParamField query="starting_after" type="string">
  Cursor for forward pagination.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.stablegenius.co/v1/transactions?merchant_id=mer_abc123&limit=25" \
    -H "Authorization: Bearer sk_test_abc123"
  ```

  ```javascript Node.js theme={null}
  const params = new URLSearchParams({
    merchant_id: 'mer_abc123',
    limit: '25',
  });

  const response = await fetch(
    `https://api.stablegenius.co/v1/transactions?${params}`,
    { headers: { Authorization: 'Bearer sk_test_abc123' } }
  );

  const { data, has_more, total_count } = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "txn_def456",
        "object": "transaction",
        "payment_intent_id": "pi_xyz789",
        "merchant_id": "mer_abc123",
        "status": "confirmed",
        "amount": 4.50,
        "currency": "usd",
        "net_amount": 4.455,
        "fee": 0.045,
        "chain": "base",
        "token": "USDC",
        "tx_hash": "0xabc123...def456",
        "settlement_status": "pending",
        "confirmed_at": "2026-04-01T20:00:12Z",
        "metadata": { "order_id": "order_456" }
      }
    ],
    "has_more": false,
    "total_count": 51
  }
  ```
</ResponseExample>