Skip to main content
GET
/
api
/
departments
/
{id}
/
users
Get users in a department
curl --request GET \
  --url https://your-instance.example.com/api/departments/{id}/users \
  --header 'Authorization: Bearer <token>'
{
  "users": [
    {
      "_id": "65b1f0a2c3d4e5f6a7b8c9d0",
      "fullName": "Alice Rivera",
      "email": "alice@example.com",
      "accessRole": "AGENT"
    }
  ],
  "department": {
    "_id": "65c1a0b0c0d0e0f0a0b0c0d1",
    "name": "Sales",
    "organizationId": "65a0e0e0e0e0e0e0e0e0e0e0"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Response

Department users returned

​
users
object[]
​
department
object
Example:
{
  "_id": "65c1a0b0c0d0e0f0a0b0c0d1",
  "name": "Sales",
  "description": "Inbound + outbound sales reps",
  "organizationId": "65a0e0e0e0e0e0e0e0e0e0e0",
  "managerIds": [
    {
      "_id": "65b1f0a2c3d4e5f6a7b8c9e0",
      "fullName": "Brenda Lee",
      "email": "brenda@example.com",
      "accessRole": "ADMIN"
    }
  ],
  "userIds": [
    {
      "_id": "65b1f0a2c3d4e5f6a7b8c9d0",
      "fullName": "Alice Rivera",
      "email": "alice@example.com",
      "accessRole": "AGENT"
    }
  ],
  "createdBy": {
    "_id": "65b1f0a2c3d4e5f6a7b8c9e0",
    "fullName": "Brenda Lee",
    "email": "brenda@example.com"
  },
  "updatedBy": {
    "_id": "65b1f0a2c3d4e5f6a7b8c9e0",
    "fullName": "Brenda Lee",
    "email": "brenda@example.com"
  },
  "createdAt": "2026-01-12T09:00:00.000Z",
  "updatedAt": "2026-04-04T12:30:00.000Z"
}