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
}
Transactions
List Transactions
List confirmed transactions with filtering and pagination
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
string
required
Filter by merchant ID.
string
Filter by status. One of:
confirmed, settled, failed.string
ISO 8601 timestamp. Only return transactions confirmed after this time.
string
ISO 8601 timestamp. Only return transactions confirmed before this time.
integer
Number of results per page. Default: 25. Max: 100.
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
}