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

> List payment intents with filtering and pagination

# List Payment Intents

Returns a paginated list of payment intents, optionally filtered by merchant, status, or date range.

## Query Parameters

<ParamField query="merchant_id" type="string">
  Filter by merchant ID. Required unless your API key is scoped to a single merchant.
</ParamField>

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

<ParamField query="created_after" type="string">
  ISO 8601 timestamp. Only return intents created after this time.
</ParamField>

<ParamField query="created_before" type="string">
  ISO 8601 timestamp. Only return intents created 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. Pass the `id` of the last item in the previous page.
</ParamField>

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

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

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

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

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "pi_xyz789",
        "object": "payment_intent",
        "status": "confirmed",
        "amount": 4.50,
        "currency": "usd",
        "net_amount": 4.455,
        "fee": 0.045,
        "merchant_id": "mer_abc123",
        "tx_hash": "0xabc123...def456",
        "chain": "base",
        "token": "USDC",
        "confirmed_at": "2026-04-01T20:00:12Z",
        "metadata": { "order_id": "order_456" },
        "created_at": "2026-04-01T20:00:00Z"
      },
      {
        "id": "pi_abc456",
        "object": "payment_intent",
        "status": "confirmed",
        "amount": 12.00,
        "currency": "usd",
        "net_amount": 11.88,
        "fee": 0.12,
        "merchant_id": "mer_abc123",
        "tx_hash": "0xdef789...abc012",
        "chain": "base",
        "token": "USDC",
        "confirmed_at": "2026-04-01T19:45:30Z",
        "metadata": { "order_id": "order_455" },
        "created_at": "2026-04-01T19:45:00Z"
      }
    ],
    "has_more": true,
    "total_count": 142
  }
  ```
</ResponseExample>