Bag DocsAPI ReferenceEvents
List events
Returns a paginated list of webhook delivery events for the authenticated merchant. Use this to replay missed webhooks, audit payment history, or debug delivery failures.
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
event?string
Filter by event type (e.g. payment.completed).
Value in
"payment.completed" | "payment.failed" | "subscription.created" | "subscription.updated" | "subscription.renewed" | "subscription.renewal_due" | "subscription.past_due" | "subscription.canceled"status?string
Filter by delivery status.
Value in
"pending" | "delivered" | "failed"since?string
Only return events created after this ISO 8601 timestamp.
Format
date-timeuntil?string
Only return events created before this ISO 8601 timestamp.
Format
date-timestarting_after?string
Cursor for pagination. Pass the id of the last event from the previous page.
Format
uuidlimit?integer
Maximum number of events to return (1-100, default 25).
Default
25Range
1 <= value <= 100Response Body
application/json
application/json
curl -X GET "https://getbags.app/api/events"{
"status": "success",
"data": [
{
"id": "a7b8c9d0-e1f2-4a3b-4c5d-6e7f8a9b0c1d",
"endpointId": "f6a7b8c9-d0e1-4f2a-3b4c-5d6e7f8a9b0c",
"event": "payment.completed",
"payload": {
"event": "payment.completed",
"data": {
"sessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"amount": 29.99,
"network": "base"
},
"timestamp": "2026-03-01T12:05:00.000Z"
},
"status": "delivered",
"attempts": 1,
"responseStatus": 200,
"lastAttemptAt": "2026-03-01T12:05:01.000Z",
"createdAt": "2026-03-01T12:05:00.000Z"
}
],
"hasMore": false
}{
"status": "error",
"message": "Invalid or revoked API key",
"code": "UNAUTHORIZED",
"hint": "Include a valid API key in the Authorization header: Bearer bag_live_sk_..."
}