API ReferenceWebhooks
List webhook endpoints
Returns all webhook endpoints for the authenticated merchant, along with recent delivery attempts for each endpoint. Use this to monitor webhook health and debug failed deliveries.
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/webhooks"{
"status": "success",
"data": {
"endpoints": [
{
"id": "f6a7b8c9-d0e1-4f2a-3b4c-5d6e7f8a9b0c",
"url": "https://api.example.com/webhooks/bag",
"events": [
"payment.completed",
"payment.failed"
],
"active": true,
"createdAt": "2026-01-15T08:00:00.000Z"
}
],
"recentDeliveries": [
{
"id": "a7b8c9d0-e1f2-4a3b-4c5d-6e7f8a9b0c1d",
"endpointId": "f6a7b8c9-d0e1-4f2a-3b4c-5d6e7f8a9b0c",
"event": "payment.completed",
"status": "delivered",
"attempts": 1,
"createdAt": "2026-02-28T14:22:05.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_..."
}