Events

GET /api/v1/events returns immutable, thin evt_ event references. Event types span merchant, locations, catalog, inventory, customers, orders, payments, suppliers, purchases, and fiscal documents. The caller must hold the scope for every explicitly requested type.

Events are filtered by current merchant, scopes, and location grants. Fetch the current resource to hydrate a thin reference. Deduplicate by event ID, expect at-least-once observation, and do not assume exactly-once delivery or global ordering.

See Event Polling & Reconciliation for chronological and recent modes.