---
title: "Retrieves the collection of Department resources."
method: GET
path: "/departments"
tags: ["Department"]
---

# Retrieves the collection of Department resources.

`GET /departments`

## Request

- Base URL: `https://example.myintranetapps.com/api`
- URL: `https://example.myintranetapps.com/api/departments`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/bossinsights/apis/boss-insights/docs/departments/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the collection of Department resources.

## Query parameters

- `page` integer
- `itemsPerPage` integer

## Response `200`

Department collection

- Department[]
  - `id` string
  - `integration` string: The key of the integration source e.g. "quickbooks", or "xero"
  - `name` string
  - `directory` string, nullable: List the directory of the current department e.g. Parent:Department1:SubDepartment1:SubDepartment2
  - `subDepartment` boolean, nullable: Boolean on if this department is a subdepartment
  - `active` boolean: Boolean on if department is currently active
  - `created` string, date-time, nullable: Date entry was created
  - `modified` string, date-time, nullable: Date entry was last modified

---

[API](https://skmtc.dev/bossinsights/apis/boss-insights.md) - [All operations](https://skmtc.dev/bossinsights/apis/boss-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/bossinsights/apis/boss-insights/revisions/d08a107895ad?raw)