---
title: "GET /v1/public/stats/models/{model}"
method: GET
path: "/v1/public/stats/models/{model}"
tags: ["Stats"]
---

# GET /v1/public/stats/models/{model}

`GET /v1/public/stats/models/{model}`

Get usage statistics for a specific model.
Returns time series data showing token usage over time.

## Path parameters

- `model` string, required

## Query parameters

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

## Response `200`

Ok

- union
  - ResultSuccessModelStatsResponse
    - `data` ModelStatsResponse, required
      - `model` string, required
      - `totalTokens` number, double, required
      - `timeSeries` ModelStatsTimeSeriesDataPoint[], required
        - `time` string, required
        - `totalTokens` number, double, required
    - `error` null, nullable, required
  - ResultErrorString
    - `data` null, nullable, required
    - `error` string, required

## Changes

- **2025-12-20** `928fb2f267bc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/helicone/apis/helicone-api/changes/v1/public/stats/models/:model/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-service-production.skmtc.workers.dev/v1/apis/helicone/helicone-api/revisions/dfd1a960c421/schema)