List departments

GET

/domains/{domain}/departments

Last modified:2026-10-09 00:50:53

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

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

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//departments?limit=undefined&start=undefined&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-10-09 00:50:53

List departments (list suffix)

Count departments