API reference

Events

Every webhook delivery lives in an Events table for 30 days. Useful when your handler missed a delivery (timeout, deploy outage) — re-fetch by id or list chronologically and replay against your processing queue.

List events

GET/v1/eventsscope: events:read

Cursor-paginated, newest first. Filter by type (e.g. payment.succeeded) for a single channel.

Query parameters

`type` string	Event type filter, e.g. `payment.succeeded`.
`created_after` number	Only events created at or after this Unix timestamp (seconds).
`created_before` number	Only events created at or before this Unix timestamp (seconds).
`cursor` string	Pagination cursor (bare UUID).
`limit` number	1–100, default 20.

curl "https://baynoy.com/api/v1/events?type=payment.succeeded&limit=10" \
  -H "Authorization: Bearer sk_test_…"

Response

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "evt_7c9a1b2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
        "object": "event",
        "type": "payment.succeeded",
        "livemode": true,
        "created": 1748180400,
        "data": {
          "object": {
            "id": "8f7e6d5c-4b3a-2918-7654-3210fedcba98",
            "amount": 2000,
            "currency": "chf",
            "status": "succeeded"
          }
        }
      }
    ],
    "nextCursor": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "hasMore": true
  }
}