API ReferencePayment links
List payment links
Returns all payment links belonging to the merchant identified by the API key. Optionally filter by wallet address if the merchant has multiple receiving wallets.
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 results to links created for this specific wallet address. When omitted, returns links for all wallets associated with your API key.
Response Body
application/json
application/json
application/json
curl -X GET "https://api.justusebag.xyz/api/payment-links"{
"status": "success",
"data": [
{
"_id": "d4e5f6a7-b8c9-4d0e-a1f2-b3c4d5e6f7a8",
"name": "Pro Plan",
"description": "Monthly subscription to Pro features",
"amount": 29.99,
"currency": "USD",
"network": "base",
"networks": [
"base",
"polygon"
],
"token": "USDC",
"active": true,
"merchantWalletAddress": "0x1a2B3c4D5e6F7890abCdEf1234567890aBcDeF12",
"merchantName": "Acme Corp",
"totalCollected": 899.7,
"totalTransactions": 30,
"createdAt": "2025-11-15T08:30:00.000Z",
"updatedAt": "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
}