Announcing the Square Reporting API (Beta)
We’re excited to announce the Square Reporting API is now in open beta and available to all developers.
The problem it solves
Building accurate business reports on Square data has historically meant stitching together 6–7 separate API endpoints (Payments, Orders, Inventory, etc.), reconciling inconsistencies, and still not matching what sellers see in their Dashboard. Even then, some data simply wasn’t accessible through existing APIs at all.
What’s new
The Reporting API gives you a single, dynamic query interface built on the Square Intelligence Platform — the same data layer that powers Square Dashboard. This means developers can:
- Accurately reconstruct existing reports — query the same underlying data as Square Dashboard, so your numbers match exactly. No more wild calculations to reconcile figures.
- Build net-new reports — combine dimensions and metrics across domains (sales, payments, customers, catalog, kitchen performance, and more) in ways that weren’t possible before.
- Tap into previously unavailable data — access a broader range of data points that were never exposed through other Square APIs, unlocking entirely new insights for sellers.
All through a familiar query model — define dimensions, metrics, filters, and time ranges in a single REST call.
Getting started
- Visit the Reporting API documentation for guides, authentication setup, and example queries
- Explore the schema with our interactive data model explorer to see all available cubes, dimensions, and metrics
- Authenticate with a Personal Access Token or OAuth and start querying
Beta details
- The API is stable and production-ready, but field names or schemas may evolve — watch the changelog for updates
- We welcome feedback! Reply to this thread with questions, feature requests, or anything you’d like to see added
What’s ahead
We’re actively expanding the data surface — disputes, authorization, and acceptance data are on the roadmap.
Happy building! 