> ## Documentation Index
> Fetch the complete documentation index at: https://exsited.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Departments

> Read the departments configured in Exsited: list them a page at a time or retrieve one by its id.

Departments are the organisational units configured in your Exsited settings, each tied to a division. You can list them and retrieve one by its id. This area has 2 endpoints, each available in all seven SDKs.

## At a glance

| Endpoint | Method | Path | What it does |
| - | - | - | - |
| [List departments](https://exsited.mintlify.site/api-reference/departments/list-departments.md) | GET | `/settings/departments` | Lists the departments set up in Exsited, one page at a time. |
| [Retrieve a department](https://exsited.mintlify.site/api-reference/departments/retrieve-a-department.md) | GET | `/settings/departments/{department_id}` | Retrieves one department by its `dept_` id. |

## Before you call

Register your API credentials once when your app starts, as shown in
[Authentication](https://exsited.mintlify.site/authentication.md). Every SDK sample on these pages then gets its client in one line.
With cURL, send the access token in an `Authorization` header: `Authorization: Bearer $ACCESS_TOKEN`.

## Things to know

* **Departments are read only here.** This area lists and retrieves departments; it has no create, update or delete call.
* **Department ids start with `dept_`.** Pass that `id` as `department_id`.
* **The list pages by cursor.** Records are under `data`; pass `pagination.next_cursor` as `cursor` while `pagination.has_more` is `true`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.