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

# GET /v1/iam/roles/{id}

`GET /v1/iam/roles/{id}`

GetRole 获取角色详情，返回角色基础信息以及已绑定的权限 ID、菜单 ID。

## Path parameters

- `id` string, required

## Response `200`

OK

- IamV1GetRoleReply
  - `menuIds` string[]
  - `permissions` IamV1Permission[]
    - `action` string — 操作标识，可自定义，如 read/create/update/delete。
    - `code` string — 权限唯一编码，创建后不可修改。
    - `createdAt` string, date-time
    - `description` string
    - `id` string
    - `isBuiltin` boolean — 内置权限。内置权限禁止更新和删除。
    - `module` string — 模块名称，用于前端分组和筛选，可自定义。
    - `moduleCode` string — 模块英文码（如 permission/settings），由后端按内置模块目录派生， 供前端多语言展示用的稳定 key；自定义模块无对应码时为空串。
    - `name` string
    - `parentId` string — 父权限 ID，0 表示顶级权限分组。
    - `resource` string — 资源标识，可自定义。
    - `updatedAt` string, date-time
  - `role` 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 — 最后修改人展示名；空表示未修改过、系统修改或用户已不存在。

---

[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)