Skip to main content
GET
/
v1
/
transactions
curl "https://api.stablegenius.co/v1/transactions?merchant_id=mer_abc123&limit=25" \
  -H "Authorization: Bearer sk_test_abc123"

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();

{
  "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
}

​
List Transactions

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

​
Query Parameters

​
merchant_id
string
required
Filter by merchant ID.
​
status
string
Filter by status. One of: confirmed, settled, failed.
​
date_from
string
ISO 8601 timestamp. Only return transactions confirmed after this time.
​
date_to
string
ISO 8601 timestamp. Only return transactions confirmed before this time.
​
limit
integer
Number of results per page. Default: 25. Max: 100.
​
starting_after
string
Cursor for forward pagination.
curl "https://api.stablegenius.co/v1/transactions?merchant_id=mer_abc123&limit=25" \
  -H "Authorization: Bearer sk_test_abc123"

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();

{
  "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
}