---
title: "Get Departement by id (v3)"
method: GET
path: "/api/v3/departments/{id}"
tags: ["Departments"]
deprecated: true
---

# Get Departement by id (v3)

`GET /api/v3/departments/{id}`

> **Deprecated.**

Retrieve a single Department by its unique identifier.

## Response `200`

OK

- object
  - `data` Department — Departments, to which users must be attached, are used by the different Lucca solutions for different purposes: * Define access scopes: for example to restrict the visibility of absences in the Lucca Absences schedule. * Filtering data in a report: our different reports generally allow to filter data according to the legal entity, the SSC, but also the department of the user. * Build the organization chart in Lucca Core HR. The departments are represented as a hierarchical tree with a parent/child relationship. *NB:* You can have up to 9 levels of departments, and up to 99 departments under a single parent department. However, limiting the number of levels to 7 is recommended.
    - `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
- `404` — Generique error message response
- `500` — Generique error message response

---

[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)