Get aggregate organization stats

GET

/api/v1/organizations/stats

const url = 'http://localhost:3000/api/v1/organizations/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/organizations/stats \
  --header 'X-API-Key: <X-API-Key>'

Returns total organization count and counts by status. Requires Super Admin privileges.

Authorizations

api-key
bearer

Responses

200

Aggregate stats retrieved successfully

application/json

object

total

required

Total number of organizations

number

byStatus

required

Organization counts grouped by status

object

active

required

Number of active organizations

number

suspended

required

Number of suspended organizations

number

pending

required

Number of pending organizations

number

disabled

required

Number of disabled organizations

number

Example

{
  "total": 16,
  "byStatus": {
    "active": 10,
    "suspended": 2,
    "pending": 3,
    "disabled": 1
  }
}

401

Unauthorized

403

Forbidden - Super Admin required