---
title: "Get departments list"
method: GET
path: "/company/v1/departments"
tags: ["departments (usersService)"]
---

# Get departments list

`GET /company/v1/departments`

## Request

- Base URL: `https://{domain}.uspacy.ua`
- URL: `https://{domain}.uspacy.ua/company/v1/departments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/uspacy/apis/uspacy-api-2/docs/company/v1/departments/get.ts> (a function with typed inputs; its response is checked against the schema)

Get departments list

## Query parameters

- `page` integer
- `list` number

## Response `200`

OK

- object
  - `data` Department[]
    - `id` integer
    - `description` string
    - `name` string
    - `headId` string
    - `parentDepartmentId` string
    - `usersIds` string
    - `roles` string[]
  - `meta` Meta
    - `currentPage` number
    - `from` number
    - `lastPage` number
    - `links` object[]
      - `url` string
      - `label` string
      - `active` boolean
    - `path` string
    - `perPage` number
    - `to` number
    - `total` number

## Other responses

- `401`: Access token is missing or invalid

---

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