> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

获取指定时间范围内，企业在各客户端的活跃成员数。
## 所需权限 {#24460232}
`statistics`
## 请求方式 {#bde6271b}
```HTTP
GET /openapi/v1/statistics/active-users
```

## 请求参数 {#068dd195}
<!-- @cols-width: 146,146,100,146,301 -->
| | | | | | \
|**参数** |**类型** |**是否必填** |**默认值** |**描述** |
|---|---|---|---|---|
| | | | | | \
|`start_date` |string |是 |\- |开始日期。格式：YYYY-MM-DD。 |
| | | | | | \
|`end_date` |string |是 |\- |结束日期。格式：YYYY-MM-DD。 |
| | | | | | \
|`timezone` |string |否 |`"Asia/Shanghai"` |时区。需使用 IANA 时区名称。 |

## 响应参数 {#e7f7bf4b}
<!-- @cols-width: 244,244,350 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`total_active_users` |int |所有客户端去重后的活跃成员总数。如果同一成员在多个客户端上活跃，只会被计算一次。 |
| | | | \
|`ide_active_users` |int |TRAE IDE 中的活跃成员数。 |
| | | | \
|`plugin_active_users` |int |TRAE 插件中的活跃成员数。 |
| | | | \
|`cli_active_users` |int |TRAE CLI 中的活跃成员数。 |

## 请求示例 {#423bbfe2}
```Bash
curl -X GET "https://{domain}/openapi/v1/statistics/active-users?start_date=2026-01-01&end_date=2026-01-31" \
  -H "Authorization: Bearer {access_token}"
```

## 响应示例 {#47c6b5a3}
```JSON
{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "total_active_users": 150,
    "ide_active_users": 80,
    "plugin_active_users": 60,
    "cli_active_users": 30
  }
}
```