List departments

GET

/domains/{domain}/departments

Last modified:2026-09-27 18:53:32

OperationId:ReadDepartments

Returns the domain's departments with a member count for each, sorted by name, 100 by default. A department is a label users are filed under through their own department field.

Requires Office Manager, Site Manager, or Basic User in the domain, Reseller for a domain in your territory, or Super User or Super User Read Only. Other scopes, and a Reseller outside its territory, get 403.

The list joins two sources: the departments declared in the domain, and every name users are actually filed under. A department appears as soon as one user carries it, and count-users-total is 0 for a declared department with no users.

Page with start and limit, and filter on one name with department. Use GET /domains/{domain}/departments/count for a total.

Departments are read-only here. File a user under one by setting the user's department field with the user endpoints.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The domain's departments, possibly an empty array.

Bodyapplication/json

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/departments?limit=25&start=0&department=Sales' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Two departments

One with members, one declared but empty.

[
    {
        "department": "Sales",
        "domain": "example.com",
        "count-users-total": 12
    },
    {
        "department": "Support",
        "domain": "example.com",
        "count-users-total": 0
    }
]

Modified at 2026-09-27 18:53:32

List departments (list suffix)

Count departments