---
title: "GET /v1/public/stats/provider-usage"
method: GET
path: "/v1/public/stats/provider-usage"
tags: ["Stats"]
---

# GET /v1/public/stats/provider-usage

`GET /v1/public/stats/provider-usage`

Get provider usage statistics for the AI Gateway.
Returns time series data and a leaderboard of top 9 providers + others.

## Query parameters

- `timeframe` '24h' | '7d' | '30d' | '3m' | '1y'

## Response `200`

Ok

- union
  - ResultSuccessProviderUsageResponse
    - `data` ProviderUsageResponse, required
      - `timeSeries` ProviderUsageTimeSeriesDataPoint[], required
        - `time` string, required
        - `providers` ProviderTokens[], required
          - `provider` string, required
          - `totalTokens` number, double, required
      - `leaderboard` ProviderUsageLeaderboardEntry[], required
        - `rank` number, double, required
        - `provider` string, required
        - `totalTokens` number, double, required
        - `percentChange` number, double, nullable, required
    - `error` null, nullable, required
  - ResultErrorString
    - `data` null, nullable, required
    - `error` string, required

## Changes

- **2025-12-18** `9888008a3ce5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/helicone/apis/helicone-api/changes/v1/public/stats/provider-usage/get.md)

---

[API](https://skmtc.dev/helicone/apis/helicone-api.md) · [All operations](https://skmtc.dev/helicone/apis/helicone-api/llms.txt) · [OpenAPI document](https://skmtc.dev/helicone/apis/helicone-api/revisions/35826db2ca85?raw)