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

# 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

---

[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/7ee2ad97db78/schema)