---
title: "List Departments (v3)"
method: GET
path: "/api/v3/departments"
tags: ["Departments"]
deprecated: true
---

# List Departments (v3)

`GET /api/v3/departments`

> **Deprecated.**

List all Departments satisfying query filters.

## Query parameters

- `headId` integer
- `parentId` integer
- `paging` string, required

## Response `200`

OK

- object
  - `data` object
    - `items` Department[]
      - `id` integer
      - `name` string, required
      - `code` string, required
      - `hierarchy` string — Position of the departement in the hierarchical tree
      - `parentId` string — Position of the parent department in the hierarchical tree
      - `isActive` boolean
      - `position` integer — Department's general position in the hierarchy
      - `level` integer — level of the Department. Deduce from Position.
      - `sortOrder` integer — Order of the current Department among the children of the Parent Department
      - `headID` integer — ID of the User who is the head of the department
      - `head` SimpleUser
        - `id` integer
        - `name` string
        - `url` string, uri
      - `users` SimpleUser[] — Users of the department, including inactive users.
        - `id` integer
        - `name` string
        - `url` string, uri
      - `currentUsers` SimpleUser[] — Only active users of the department
        - `id` integer
        - `name` string
        - `url` string, uri
      - `currentUsersCount` integer — Number of active users in the department

## Other responses

- `400` — Generique error message response
- `401` — Generique error message response
- `500` — Internal Server Error

---

[API](https://skmtc.net/luccasoftware/apis/lucca-expenses.md) · [All operations](https://skmtc.net/luccasoftware/apis/lucca-expenses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luccasoftware/lucca-expenses/revisions/110f9897756c/schema)