Retrieve a department
Retrieve a single department by ID.
Authorizations
The Lucca API implements the oAuth 2 protocol with the client-credentials-flow. Refer to RFC8725.
Headers
Only execute the request if current cached version of the resource does not match the one given here.
"W/q5sd4w2x1c1gfdg"
Only execute the request if current cached version of the resource matches the one given here. Useful to avoid concurrency conflicts.
"W/q5sd4w2x1c1gfdg"
List of compression algorithms you support.
Path Parameters
Identifier of the department to retrieve.
1
Query Parameters
Include metadata:
embedded
: the partial or complete representations of related resources (e.g. the employee the resource belongs to).links
: links to related resources or actions (e.g. approving a leave-request). May benull
when you do not have access to the resource (or action).totalCount
: only applicable on collections (i.e. lists of resources), gives the total number of items across all pages.
Read more about expanding responses.
Response
OK
A department resource. Embedded resources on a department(s) response. A department represents a subdivision of the employee workforce, most often erected around the type of activity they do.
Departments are a tree-like structure, as any department may be child to another.
Note: contrary to most resources, departments are not attached to business-establishments. This means:
- business-establishments listed in access rights management do not affect departments.
- employees may work in different business-establishments (or even legal-entities) and yet still belong to the same department.