---
title: "GET /v1/iam/roles"
method: GET
path: "/v1/iam/roles"
tags: ["IAMService"]
---

# GET /v1/iam/roles

`GET /v1/iam/roles`

ListRoles 列举角色。支持分页、关键字和 status 过滤；status=0 表示不过滤。

## Query parameters

- `page` integer
- `pageSize` integer
- `keyword` string
- `status` integer

## Response `200`

OK

- IamV1ListRolesReply
  - `roles` IamV1Role[]
    - `createdAt` string, date-time
    - `createdBy` string — 创建人 user_id；为 0 表示系统/迁移创建（历史数据）。
    - `createdByName` string — 创建人展示名（昵称优先，回退用户名）；空表示系统创建或用户已不存在。
    - `dataScope` integer — 数据范围：1=全部数据，2=部门数据，3=仅本人，4=自定义。
    - `description` string
    - `id` string
    - `isBuiltin` boolean — 内置角色。内置角色禁止删除，且禁止修改 status。
    - `name` string
    - `sortOrder` integer
    - `status` integer — 状态：1=启用，2=禁用。
    - `updatedAt` string, date-time
    - `updatedBy` string — 最后修改人 user_id；为 0 表示未修改过或系统修改。
    - `updatedByName` string — 最后修改人展示名；空表示未修改过、系统修改或用户已不存在。
  - `total` string

---

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