API ReferenceSettlements
List settlements
Returns all settlement (payout) records for the authenticated merchant. Settlements represent funds withdrawn from your Bag balance to an external wallet.
Authorization
privy AuthorizationBearer <token>
Privy JWT authentication for dashboard and management endpoints. This is used internally by the Bag Dashboard and is not intended for direct API integrations. Use API keys instead.
In: header
Response Body
application/json
application/json
curl -X GET "https://api.justusebag.xyz/api/settlements"{
"status": "success",
"data": [
{
"id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
"amount": 500,
"token": "USDC",
"network": "base",
"destinationWallet": "0xPaYoUt1234567890abCdEf1234567890aBcDeF12",
"txHash": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef1234567890abcdef1234567890",
"status": "completed",
"createdAt": "2026-02-25T16:00: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_..."
}