Read events and event types

Use event APIs to inspect activity visible to the API-key service account:

curl --fail-with-body "$INKIT_BASE_URL/api/v1/events?page=1&page_size=25" \
  --header "X-Inkit-API-Token: $INKIT_API_KEY"

Retrieve one event through /api/v1/events/{evnt_id}. Retrieve event-type metadata through /api/v1/events/types; optional filters include webhook_subscribable, subscribable, and billable.

Events include an id, resource information, creation time, an events_type object, and optional actor/activity fields. Depending on the event, payload, signer, bcc, geolocation, and destination-specific fields may be present. Treat optional fields as optional.

Event visibility is permission-dependent. List results exclude API-key events for non-admin callers. A direct lookup can return 404 when the caller cannot access the event's resource.

An event type's webhook_subscribable field does not mean webhooks can be configured with an API key. Webhook-management routes in the production application use session authentication. Existing configured webhook delivery is separate from event polling.