---
title: "Departments list"
method: GET
path: "/departments"
tags: ["Departments"]
---

# Departments list

`GET /departments`

## Request

- Base URL: `https://hurma.work/api/v1`
- URL: `https://hurma.work/api/v1/departments`
- Auth: none declared. Required headers: `token`
- TypeScript: <https://skmtc.dev/hurma/apis/hurma-public-api-v1-endpoints/docs/departments/get.ts> (a function with typed inputs; its response is checked against the schema)

Handle HTTP requests regarding Customers.

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `token` string, required

## Response `200`

ОК

- DepartmentsListResponse: Department data
  - `result` object
    - `current_page` integer
    - `data` object[]
      - `id` integer
      - `type` integer
      - `name` string
      - `number_of_members` integer
      - `number_of_members_with_subteams` integer
      - `team_leader_id` string
      - `hr_ids` string[]
      - `managers` string[]
      - `subteams` integer[]
      - `parent_id` integer, nullable
    - `first_page_url` string
    - `from` integer
    - `last_page` integer
    - `last_page_url` string
    - `next_page_url` string, nullable
    - `path` string, nullable
    - `per_page` integer
    - `prev_page_url` string, nullable
    - `to` integer
    - `total` integer
  - `error` boolean
  - `code` integer
  - `messages` string[]

## Other responses

- `403`: Forbidden
- `422`: Invalid request parameters

## Changes

- **2026-08-06** `c2e35a68e512`: 1 info
  - api operation id `f872668816930ee221eaefbd07b4a99e` was added

[Operation history](https://skmtc.dev/hurma/apis/hurma-public-api-v1-endpoints/changes/departments/get.md)

---

[API](https://skmtc.dev/hurma/apis/hurma-public-api-v1-endpoints.md) - [All operations](https://skmtc.dev/hurma/apis/hurma-public-api-v1-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/hurma/apis/hurma-public-api-v1-endpoints/revisions/c2e35a68e512?raw)