Events

GET /v1/events

Event feed (catch-up)

events:read

Ascending pull feed over the same log webhooks deliver from — each item has exactly the webhook delivery shape (the snapshot form, regardless of what your endpoints are set to). RETENTION: 90 days, the same window as replay. Use this to catch up after downtime; use replay when you want the deliveries retried to your endpoint instead.

Parameter	In	Type	Required	Description
since	query	string	No	ISO-8601 — events from this instant
type	query	string	No	One catalogue event type
limit	query	integer	No	Page size, 1-200 (default 50)
cursor	query	string	No	Opaque cursor from meta.nextCursor

Request exampleNo request body

curl

curl https://api.rieckflow.com/v1/events \
  -H "Authorization: Bearer $RIECK_API_KEY"

TypeScript

const svar = await rieck.request("GET", "/v1/events");

Response

{
  "data": [
    {
      "id": "evt_01J4E4Z5N6YV8E3C0KX4B7QW9M",
      "type": "invoice.paid",
      "tidsstempel": "2026-08-08T12:05:44Z",
      "organisationId": "f38d6d63-a127-45a8-8efd-02cd1239578f",
      "sag": null,
      "invoice": {
        "id": "5c0d10ec-f086-48c6-b1c7-b389a47ac6d1",
        "sekvensnummer": 4
      },
      "customer": null,
      "subscription": null,
      "data": {
        "amountOere": 156250,
        "externalReference": "order-2041"
      }
    }
  ],
  "meta": {
    "nextCursor": null
  }
}

200 Success envelopeapplication/json

Response fields 7

Field	Type	Description
data[].id	string	Deduplication key, also sent as webhook-id.
data[].type	string	Stable event type.
data[].tidsstempel	date-time	UTC event timestamp.
data[].organisationId	uuid	Organisation that owns the event.
data[].invoice.sekvensnummer	integer	Monotonic ordering per invoice.
data[].data	object	Event-specific, PII-free data.
meta.nextCursor	`string	null`

Possible errors 5

HTTP	Code	Meaning
400	invalid_cursor	The cursor is malformed, expired or belongs to another list shape.
401	invalid_api_key	The API key is missing, invalid, expired or revoked.
403	api_not_included	The organisation’s plan does not include API access.
403	insufficient_scope	The key does not have the required scope.
429	rate_limited	The organisation’s rate budget is exhausted.