Introducing the New Statistics API

We’re excited to introduce a brand-new Statistics API, designed to give you broader, faster, and more flexible access to the performance metrics you rely on.

👉 API Documentation

Why a New API?

Until now, developers could access a limited set of metrics through the existing Stats API:

https://developers.gorgias.com/reference/post_api-stats-name

As the Helpdesk evolved, many new metrics were added to our reporting engine, but these were not available in the legacy API. The reason is simple: our newer metrics rely on a different, more powerful analytics engine built specifically for large-scale, multi-dimensional reporting.

To ensure the best possible experience, we built a dedicated Statistics API that is faster, more reliable, and fully aligned with the reporting capabilities available in the Helpdesk. It reflects how metrics are computed in the product today and gives us a solid, future-ready foundation.

What’s New

The new Statistics API offers:

Access to a much broader set of metrics, currently covering 80% of what you see in the Helpdesk

Significantly improved performance, optimized for analytics-heavy workloads

More flexible filtering, dimensions, and aggregation options

A scalable foundation for all future Helpdesk reporting capabilities

We aim to reach 100% metric coverage in 2026, at which point the legacy Stats API will be fully deprecated on December 31st, 2026.

A concrete example of greater flexibility

One of the biggest improvements is the ability to combine multiple dimensions in a single query.

With the legacy Stats API:

You could retrieve the number of closed tickets

Apply some filtering (e.g., include only specific agents)

And break that number down by agent or by channel

But doing both at the same time wasn’t possible, and adding more complex breakdowns (like by store) wasn’t supported.

With the new Statistics API, you can:

Break down closed tickets by agent AND channel

Add additional dimensions like store, integration, etc.

Apply advanced filters in the same request

Build reports that mirror (or exceed) what you can do in the Helpdesk interface

This makes the API far more powerful and much better suited for custom dashboards, BI tools, and advanced data workflows.

What Happens to the Legacy Stats API?

The existing Stats API will remain available and unchanged for now.

All new integrations, dashboards, and reporting workflows should use the new Statistics API, as this is where all future improvements will happen.

The legacy Stats API will be officially sunset on December 31st, 2026, once the new API reaches full coverage.

What’s Next

In the coming months, we will:

Add the remaining Helpdesk metrics

Expand available dimensions and filtering options