Events
Use this page to read the raw audit-backed event feed.
Who This Is For
- operators investigating mutations and actor behavior
- developers polling a raw event history feed
- teams that need audit-chain-backed event visibility
When To Use This
Use events when you need raw audit history rather than normalized reporting activity.
If you need a broader reporting feed, use Activities.
How It Works
GET /api/v1/events uses event:read.
Available filters:
cursorlimitevent_typeresource_typeresource_idactor_type
Response shape:
data:Event[]page_info.next_cursormeta
This is the audit-backed event feed. It is useful for mutation history and provenance, but it is not the normalized commercial reporting feed.
Example
bash
curl "https://api.licensekit.dev/api/v1/events?resource_type=license&resource_id=lic_123&limit=50" \
-H "Authorization: Bearer $LICENSEKIT_TOKEN"Common Mistakes
- treating the events feed as if it were the reporting activity feed
- expecting time-window query parameters that are not part of this endpoint
- using
report:readinstead ofevent:read