---
title: "Get Usage Statistics"
method: GET
path: "/api/v1/subscription/usage"
tags: ["subscription", "web_app", "NOT_USED"]
---

# Get Usage Statistics

`GET /api/v1/subscription/usage`

获取用户使用统计

## Response `200`

Successful Response

- APIResponseUsageStatisticsResponse
  - `code` integer
  - `message` string
  - `data` UsageStatisticsResponse — 使用统计响应
    - `today_chat_count` integer — 今日聊天次数
    - `today_limit` integer — 今日限制
    - `total_chat_count` integer, nullable — 总聊天次数（免费用户）
    - `total_chat_limit` integer, nullable — 总聊天次数限制（免费用户）
    - `chat_24h_count` integer, nullable — 24小时内聊天次数（免费用户）
    - `chat_24h_limit` integer, nullable — 24小时内聊天次数限制（免费用户）
    - `agent_count` integer — 创建的Agent数量
    - `agent_limit` integer — Agent创建限制
    - `usage_history` SubscriptionUsage[] — 使用历史
      - `usage_type` string, required — 使用类型
      - `usage_date` string, date-time, required — 使用日期
      - `usage_count` integer — 使用次数
      - `extra_data` object, nullable — 额外元数据
      - `id` string, required
      - `user_id` string, required
      - `subscription_id` string, nullable
      - `created_at` string, date-time, required

## Changes

- **2025-11-30** `64a35ff6429d` — 1 info
  - api tag `NOT_USED` added
- **2025-11-25** `05cf5f034c74` — 1 info
  - api tag `web_app` added

[Change history](https://skmtc.dev/nascentcore/apis/inty-backend/changes/api/v1/subscription/usage/get.md)

---

[API](https://skmtc.dev/nascentcore/apis/inty-backend.md) · [All operations](https://skmtc.dev/nascentcore/apis/inty-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nascentcore/inty-backend/revisions/1e014c365df2/schema)