---
title: "List Departments"
method: GET
path: "/v1/employers/{employerId}/departments"
tags: ["Departments"]
---

# List Departments

`GET /v1/employers/{employerId}/departments`

List all departments for an employer with employee counts and visibility status.

## Path parameters

- `employerId` string, required

## Response `200`

Default Response

- object
  - `success` boolean, required
  - `departments` object[], required
    - `_id` string
    - `name` string
    - `employerId` string, nullable
    - `source` string
    - `createdAt` string, date-time
    - `createdBy` string
    - `employeeCount` number
    - `hidden` boolean
    - `type` 'default' | 'custom' | 'synced'
  - `total` number, required
  - `message` string, required

## Other responses

- `401` — Error response
- `500` — Error response

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/revisions/e6e553c2594a/schema)