Skip to content

Get organization member stats

GET
/api/v1/organizations/{orgId}/members/stats
curl --request GET \
--url http://localhost:3000/api/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/members/stats \
--header 'X-API-Key: <X-API-Key>'

Returns aggregate stats (total, byStatus, byRole) for members of the organization.

orgId
required
string format: uuid

Organization UUID

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 - Insufficient permissions

Organization not found