---
title: "Получить суточную статистику пользователя"
method: GET
path: "/v1/users/stats"
tags: ["Users"]
---

# Получить суточную статистику пользователя

`GET /v1/users/stats`

Конечная точка для получения агрегированной статистики по дням за указанный период. **Требуется авторизация.**

## Query parameters

- `start_date` string, date, nullable — Дата начала периода в формате YYYY-MM-DD. По умолчанию — 30 дней назад.
- `end_date` string, date, nullable — Дата окончания периода в формате YYYY-MM-DD. По умолчанию — сегодня.

## Response `200`

Successful Response

- UserStatsResponse — Модель ответа для эндпоинта получения статистики пользователя.
  - `period_start_date` string, date, required — Начало периода статистики
  - `period_end_date` string, date, required — Конец периода статистики
  - `total_requests` integer, required — Всего запросов за указанный период
  - `total_prompt_tokens` integer, required — Всего prompt_tokens за указанный период
  - `total_cache_read_tokens` integer, required — Всего cache_read_tokens за указанный период
  - `total_completion_tokens` integer, required — Всего completion_tokens за указанный период
  - `total_cost` string, required — Общая стоимость запросов за указанный период
  - `total_free_requests` integer, required — Всего бесплатных запросов за указанный период
  - `daily_stats` UserDailyStatPublic[], required — Список статистики по дням
    - `stat_date` string, date, required — Дата, за которую предоставлена статистика
    - `request_count` integer, required — Общее количество запросов за день
    - `prompt_tokens` integer, required — Сумма prompt_tokens за день
    - `cache_read_tokens` integer, required — Сумма cache_read_tokens за день
    - `completion_tokens` integer, required — Сумма completion_tokens за день
    - `cost_request` string, required — Общая стоимость запросов за день
    - `free_requests` integer, required — Количество бесплатных запросов за день

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/hydraai/apis/hydraai-api.md) · [All operations](https://skmtc.dev/hydraai/apis/hydraai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hydraai/hydraai-api/revisions/e628fe769ab4/schema)