List Seats Usage

Get a list of tenant members (seats), including assigned policies and seat-denied invitees.

To remove a specific member returned from this call use the Remove Member API call.

Endpoint

GET /api/rbac/seatsUsage

Authentication

This endpoint requires API Key authentication via the Authorization header. The caller must have the admin role on the tenant.

Headers

Header	Required	Description
Authorization	Yes	Bearer token with your API key
X-Tenant-UUID	Yes	Tenant UUID (from the app URL tenantUUID=…, or Settings → Access)

Response

Response Schema

[
  {
    "email": "string",
    "lastLogin": "string",
    "isActive": true,
    "firstLogin": "string",
    "roleType": "string",
    "policyUUIDs": ["string"],
    "policyNames": ["string"],
    "ssoDriven": false
  }
]

Field Descriptions

Field	Type	Description
email	string	Member email
lastLogin	string | null	ISO 8601 last login / last seen time
firstLogin	string | null	ISO 8601 first login time
isActive	boolean	true for active members; false for seat-blocked invitees
roleType	string	Effective role: admin, write, or read
policyUUIDs	array	Assigned policy UUIDs
policyNames	array	Assigned policy names (same order as UUIDs)
ssoDriven	boolean	Whether policies are driven by SSO

Examples

Basic Request

curl -L \
  --request GET \
  --url 'https://api.groundcover.com/api/rbac/seatsUsage' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'X-Tenant-UUID: <YOUR_TENANT_UUID>'

Response Example

[
  {
    "email": "[e-mail]",
    "lastLogin": "2026-09-28T13:45:56.447898Z",
    "isActive": true,
    "firstLogin": "2023-10-02T13:38:33.543846Z",
    "roleType": "admin",
    "policyUUIDs": ["6180b868-315b-4540-852f-3e0e942f5de3"],
    "policyNames": ["groundcover Admin"],
    "ssoDriven": false
  },
  {
    "email": "[e-mail]",
    "lastLogin": "2026-09-27T13:00:47.934825Z",
    "isActive": true,
    "firstLogin": "2024-06-06T11:31:49.856862Z",
    "roleType": "write",
    "policyUUIDs": ["cb7d55ac-10bb-42ec-84cc-1a00f460cf2d"],
    "policyNames": ["groundcover Editor"],
    "ssoDriven": false
  }
]