Hi Shopify team,
Could you clarify the supported API options for querying App Events, including historical events after a merchant uninstalls the app?
What the docs say
App Events documents sending events and viewing them in Dev Dashboard logs.
App Events in Analytics says:
After Shopify accepts events for analytics, merchants can query them through FROM app_events.
The App Events API reference also explains that custom events sent only for monitoring don’t appear in Shopify Analytics.
Use cases
We need programmatic access to our app’s events to:
- Build internal, cross-merchant dashboards.
- Build merchant-facing usage and activity dashboards.
- Synchronize and reconcile event data with our internal databases and systems.
This includes all App Event types: standard, custom, monitoring-only, and billing events, not just aggregated billing history.
For example, we need to determine how many times a particular event handle occurred for a shop during a date range, and retrieve the underlying event records and attributes.
Expected capability
A documented, paginated API for retrieving our app’s events, with filtering by shop, event handle, and timestamp, plus a reliable cursor for incremental synchronization.
We also need historical access after uninstall, using app- or partner-level authentication rather than a revoked shop Admin API token, subject to Shopify’s retention and privacy requirements.
This request concerns events received before uninstall, not sending new events after uninstall.
What I could find
I found documentation for event ingestion, Dev Dashboard viewing, and merchant-facing ShopifyQL analytics, but couldn’t find a documented API covering the complete use case above.
Questions
- Is there an existing API for retrieving all of our app’s App Events? If so, which endpoint, authentication method, and permissions should we use?
- Can ShopifyQL be called programmatically for declared App Events, and does it support raw records or only analytics results?
- How can we retrieve monitoring-only and billing events that aren’t exposed through the analytics dataset?
- Which event types remain queryable after uninstall, and for how long?
- What retention, pagination, and incremental synchronization guarantees apply?
If this isn’t currently supported, could this be considered a feature request for complete App Events read access, including historical access after uninstall?
Thanks.