---
title: "List"
method: GET
path: "/operations/departments/list/v1"
tags: ["/operations/departments"]
---

# List

`GET /operations/departments/list/v1`

Lists department configurations for the caller's organization with filtering, sorting, pagination, and Atlas Search. | authz: min_org_role=operator | () -> (DepartmentListRes)

## Query parameters

- `sort_by` 'created_at' | 'department_type'
- `sort_order` 'asc' | 'desc' — Sort order for query results
- `search` string, nullable — Search name and short_id using Atlas Search
- `page` integer
- `page_size` integer
- `filter_department_ids` string[], nullable — Filter by selected department ids
- `filter_department_type` DepartmentTypeEnum[], nullable — Filter by department type(s)

## Response `200`

Successful Response

- DepartmentListRes
  - `items` Department1[], required — unresolved $ref
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-24** `b5a0a0e20ff8` — 1 info
  - added the new optional `query` request parameter `filter_department_ids`
- **2026-09-11** `7cf361125675` — 1 info
  - added the new optional `query` request parameter `search`

[Change history](https://skmtc.dev/chrt/apis/chrt-fastapi/changes/operations/departments/list/v1/get.md)

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/chrt/apis/chrt-fastapi/revisions/1a1e5a995fc9?raw)