API ReferenceTransactions
List transactions
Returns all transactions for the authenticated merchant. Transactions are returned in reverse chronological order (newest first). Each transaction includes the on-chain status, customer info, and tax breakdown if applicable.
Authorization
apiKey AuthorizationBearer <token>
API key authentication for programmatic access. Include your key in the
Authorization header:
Authorization: Bearer bag_live_sk_a1b2c3d4e5f6...Keys are prefixed with bag_live_sk_ (production) or bag_test_sk_
(sandbox). Generate keys from the Bag Dashboard.
In: header
Query Parameters
merchantWalletAddress?string
Filter transactions to those received by this wallet address.
Response Body
application/json
application/json
application/json
curl -X GET "https://api.justusebag.xyz/api/transactions"{
"status": "success",
"data": [
{
"_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"amount": 29.99,
"token": "USDC",
"network": "base",
"status": "completed",
"customerEmail": "alice@example.com",
"customerName": "Alice Johnson",
"txHash": "0x8f3a2b1c4d5e6f7890abcdef1234567890abcdef1234567890abcdef12345678",
"walletAddress": "0xCuStOmEr1234567890abCdEf1234567890aBcDeF",
"merchantWalletAddress": "0x1a2B3c4D5e6F7890abCdEf1234567890aBcDeF12",
"subtotalAmount": 28.49,
"taxAmount": 1.5,
"customerCountry": "US",
"createdAt": "2026-02-28T14:22:00.000Z"
}
]
}{
"status": "error",
"message": "Invalid or revoked API key",
"code": "UNAUTHORIZED",
"hint": "Include a valid API key in the Authorization header: Bearer bag_live_sk_..."
}{
"status": "error",
"message": "Too many requests. Please slow down.",
"retryAfter": 10
}