---
title: "Get model usage data for a specific group"
method: GET
path: "/api/dashboardv2/{group}"
tags: ["dashboard"]
---

# Get model usage data for a specific group

`GET /api/dashboardv2/{group}`

Returns model-specific metrics and usage data for the given group

## Path parameters

- `group` string, required

## Query parameters

- `token_name` string
- `model` string
- `start_timestamp` integer
- `end_timestamp` integer
- `timezone` string
- `timespan` string
- `fields` string

## Response `200`

OK

- object
  - `data` ModelTimeSummaryDataV2[]
    - `summary` ModelSummaryDataV2[]
      - `audio_input_amount` number
      - `audio_input_tokens` integer
      - `audio_output_amount` number
      - `audio_output_tokens` integer
      - `cache_creation_amount` number
      - `cache_creation_count` integer
      - `cache_creation_tokens` integer
      - `cache_hit_count` integer
      - `cached_amount` number
      - `cached_tokens` integer
      - `channel_id` integer
      - `claude_long_context` ModelSummaryDataSet
        - `audio_input_amount` number
        - `audio_input_tokens` integer
        - `audio_output_amount` number
        - `audio_output_tokens` integer
        - `cache_creation_amount` number
        - `cache_creation_count` integer
        - `cache_creation_tokens` integer
        - `cache_hit_count` integer
        - `cached_amount` number
        - `cached_tokens` integer
        - `exception_count` integer
        - `image_input_amount` number
        - `image_input_tokens` integer
        - `image_output_amount` number
        - `image_output_tokens` integer
        - `input_amount` number
        - `input_tokens` integer
        - `output_amount` number
        - `output_tokens` integer
        - `reasoning_tokens` integer
        - `request_count` integer
        - `retry_count` integer
        - `status_2xx_count` integer
        - `status_400_count` integer
        - `status_429_count` integer
        - `status_4xx_count` integer
        - `status_500_count` integer
        - `status_5xx_count` integer
        - `status_other_count` integer
        - `total_time_milliseconds` integer
        - `total_tokens` integer
        - `total_ttfb_milliseconds` integer
        - `used_amount` number
        - `video_input_amount` number
        - `video_input_tokens` integer
        - `web_search_amount` number
        - `web_search_count` integer
      - `exception_count` integer
      - `group_id` string
      - `image_input_amount` number
      - `image_input_tokens` integer
      - `image_output_amount` number
      - `image_output_tokens` integer
      - `input_amount` number
      - `input_tokens` integer
      - `max_rpm` integer
      - `max_tpm` integer
      - `model` string
      - `output_amount` number
      - `output_tokens` integer
      - `reasoning_tokens` integer
      - `request_count` integer
      - `retry_count` integer
      - `service_tier_flex` ModelSummaryDataSet
        - `audio_input_amount` number
        - `audio_input_tokens` integer
        - `audio_output_amount` number
        - `audio_output_tokens` integer
        - `cache_creation_amount` number
        - `cache_creation_count` integer
        - `cache_creation_tokens` integer
        - `cache_hit_count` integer
        - `cached_amount` number
        - `cached_tokens` integer
        - `exception_count` integer
        - `image_input_amount` number
        - `image_input_tokens` integer
        - `image_output_amount` number
        - `image_output_tokens` integer
        - `input_amount` number
        - `input_tokens` integer
        - `output_amount` number
        - `output_tokens` integer
        - `reasoning_tokens` integer
        - `request_count` integer
        - `retry_count` integer
        - `status_2xx_count` integer
        - `status_400_count` integer
        - `status_429_count` integer
        - `status_4xx_count` integer
        - `status_500_count` integer
        - `status_5xx_count` integer
        - `status_other_count` integer
        - `total_time_milliseconds` integer
        - `total_tokens` integer
        - `total_ttfb_milliseconds` integer
        - `used_amount` number
        - `video_input_amount` number
        - `video_input_tokens` integer
        - `web_search_amount` number
        - `web_search_count` integer
      - `service_tier_priority` ModelSummaryDataSet
        - `audio_input_amount` number
        - `audio_input_tokens` integer
        - `audio_output_amount` number
        - `audio_output_tokens` integer
        - `cache_creation_amount` number
        - `cache_creation_count` integer
        - `cache_creation_tokens` integer
        - `cache_hit_count` integer
        - `cached_amount` number
        - `cached_tokens` integer
        - `exception_count` integer
        - `image_input_amount` number
        - `image_input_tokens` integer
        - `image_output_amount` number
        - `image_output_tokens` integer
        - `input_amount` number
        - `input_tokens` integer
        - `output_amount` number
        - `output_tokens` integer
        - `reasoning_tokens` integer
        - `request_count` integer
        - `retry_count` integer
        - `status_2xx_count` integer
        - `status_400_count` integer
        - `status_429_count` integer
        - `status_4xx_count` integer
        - `status_500_count` integer
        - `status_5xx_count` integer
        - `status_other_count` integer
        - `total_time_milliseconds` integer
        - `total_tokens` integer
        - `total_ttfb_milliseconds` integer
        - `used_amount` number
        - `video_input_amount` number
        - `video_input_tokens` integer
        - `web_search_amount` number
        - `web_search_count` integer
      - `status_2xx_count` integer
      - `status_400_count` integer
      - `status_429_count` integer
      - `status_4xx_count` integer
      - `status_500_count` integer
      - `status_5xx_count` integer
      - `status_other_count` integer
      - `timestamp` integer
      - `token_name` string
      - `total_time_milliseconds` integer
      - `total_tokens` integer
      - `total_ttfb_milliseconds` integer
      - `used_amount` number
      - `video_input_amount` number
      - `video_input_tokens` integer
      - `web_search_amount` number
      - `web_search_count` integer
    - `timestamp` integer
  - `message` string
  - `success` boolean

---

[API](https://skmtc.net/labring/apis/ai-proxy-swagger-api.md) · [All operations](https://skmtc.net/labring/apis/ai-proxy-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/labring/ai-proxy-swagger-api/revisions/696faf563b42/schema)