Get aggregate user stats
GET
/api/v1/users/stats
const url = 'http://localhost:3000/api/v1/users/stats';const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url http://localhost:3000/api/v1/users/stats \ --header 'X-API-Key: <X-API-Key>'Returns total user count and counts by status. Requires Super Admin privileges.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”User stats retrieved successfully
Media type application/json
object
total
required
Total number of users
number
byStatus
required
User counts by status
object
active
required
Number of active users
number
inactive
required
Number of inactive/disabled users
number
pending
required
Number of pending users
number
byRole
required
User counts by role
object
admin
required
Number of admin users
number
operator
required
Number of operator users
number
viewer
required
Number of viewer users
number
Example
{ "total": 25, "byStatus": { "active": 20, "inactive": 3, "pending": 2 }, "byRole": { "admin": 3, "operator": 8, "viewer": 14 }}Unauthorized
Forbidden - Super Admin required