baynoy

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`.
cursor

string

Pagination cursor.
pageSize

number

1–100, default 25.
curl "https://baynoy.com/api/v1/events?type=payment.succeeded&pageSize=10" \
  -H "Authorization: Bearer sk_live_…"
Response
{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "evt_x1y2z3-...",
        "type": "payment.succeeded",
        "created": 1748180400,
        "data": {
          "object": {
            "id": "pay_...",
            "amount": 2000,
            "currency": "chf",
            "status": "succeeded"
          }
        }
      }
    ],
    "nextCursor": "eyJpZCI6ImV2dF94MXkyejMifQ==",
    "hasMore": true
  }
}