---
title: "department groups"
method: GET
path: "/api/v1/open/departments/{department_id}/groups"
tags: ["open"]
---

# department groups

`GET /api/v1/open/departments/{department_id}/groups`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `X-Bk-App-Code`
  - API key in header `X-Bk-App-Secret`

get a department's groups

## Path parameters

- `department_id` string, required

## Response `200`

OK

- object
  - `code` integer
  - `data` HandlerResponseSubject[]
    - `id` string
    - `name` string
    - `type` string
  - `message` string

## Changes

- **2021-07-19** `361087436cc5`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/tencentblueking/apis/iam-api/changes/api/v1/open/departments/:department_id/groups/get.md)

---

[API](https://skmtc.dev/tencentblueking/apis/iam-api.md) - [All operations](https://skmtc.dev/tencentblueking/apis/iam-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tencentblueking/apis/iam-api/revisions/f3a5fe2fe9c6?raw)
