> ## 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.

获取企业的成员列表，响应数据为分页格式。
## 所需权限 {#d65130b8}
`users:read`
## 请求方式 {#cd6fa3a3}
```HTTP
GET /openapi/v1/users
```

## 请求参数 {#03592c99}
<!-- @cols-width: 146,146,146,146,255 -->
| | | | | | \
|**参数** |**类型** |**是否必填** |**默认值** |**描述** |
|---|---|---|---|---|
| | | | | | \
|`page` |int |否 |`1` |需返回的页数。 |
| | | | | | \
|`page_size` |int |否 |`100` |每页返回的成员数量，最多 500 条。 |

## 响应参数 {#f2d8ac3a}
<!-- @cols-width: 244,244,356 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`items` |array |当前页返回的成员列表。 |
| | | | \
|`pagination` |object |分页信息，用于控制翻页。 |

`items` 数组包含以下参数：
<!-- @cols-width: 244,244,356 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`user_id` |int64 |成员的 ID。 |
| | | | \
|`user_name` |string |成员的名称。 |
| | | | \
|`email` |string |成员的邮箱。 |
| | | | \
|`role` |string |成员的角色： |\
| | | |\
| | |* `super_admin`：超级管理员 |\
| | |* `admin`：管理员 |\
| | |* `member`：成员 |
| | | | \
|`status` |string |成员账号的状态： |\
| | | |\
| | |* `active`：使用中 |\
| | |* `pending`：邀请中 |
| | | | \
|`join_time` |int64 |成员加入企业的时间（毫秒时间戳）。 |

`pagination` 对象包含以下参数：
<!-- @cols-width: 190,141,321 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`page` |int |当前页码。 |
| | | | \
|`page_size` |int |每页条数。 |
| | | | \
|`total` |int |总记录数。 |
| | | | \
|`total_pages` |int |总页数。 |

## 请求示例 {#ee38dfa2}
```Bash
curl -X GET "https://{domain}/openapi/v1/users?page=1&page_size=100" \
  -H "Authorization: Bearer {access_token}"
```

## 响应示例 {#97f43d34}
```JSON
{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "items": [
      {
        "user_id": 123456,
        "user_name": "张三",
        "email": "zhangsan@example.com",
        "role": "admin",
        "status": "active",
        "join_time": 1700000000000
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 100,
      "total": 50,
      "total_pages": 1
    }
  }
}
```