Get empty organizations

GET

/api/v1/organizations/empty

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

Returns organizations with zero members. The organization the caller is currently operating in (active tenant) is never included, so it can never be purged. Requires Super Admin privileges.

Authorizations

api-key
bearer

Parameters

Header Parameters

x-organization-id

string format: uuid

UUID of the organization (tenant) the request acts in. It selects the tenant and grants nothing: the server checks membership or an open tenant switch. Not needed for global operations. A malformed value returns 400. API keys are fixed to their own organization; another organization returns 403. The x-organization-source header grants nothing.

Responses

200

Empty organizations retrieved successfully

application/json

Array<object>

object

required

Unique organization identifier

string format: uuid

name

required

Organization display name

string

slug

required

Unique URL-friendly identifier

string

description

Organization description

string

settings

required

Organization-specific settings

object

key

additional properties

any

branding

required

Organization branding configuration

object

key

additional properties

any

status

required

Organization status

string

Allowed values: active suspended pending disabled

lastActivityAt

Last activity timestamp

string format: date-time

nullable

primaryContact

Primary contact name

string

nullable

billingEmail

Billing email address

string format: email

nullable

active

required

Whether the organization is active (deprecated, use status)

boolean

createdAt

required

When the organization was created

string format: date-time

updatedAt

required

When the organization was last updated

string format: date-time

stats

Organization resource statistics

object

userCount

required

Total number of users in the organization

number

activeUsers

required

Number of active users in the organization

number

deviceCount

required

Total number of devices in the organization

number

activeDevices

required

Number of online or provisioned devices

number

deploymentCount

required

Total number of deployments in the organization

number

runningDeployments

required

Number of running deployments

number

Example

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Corporation",
    "slug": "acme-corp",
    "description": "Leading manufacturer of industrial automation equipment",
    "settings": {
      "timezone": "America/New_York",
      "locale": "en-US"
    },
    "branding": {
      "primaryColor": "#003366",
      "logo": "https://example.com/logo.png"
    },
    "status": "active",
    "lastActivityAt": "2024-06-20T14:45:00Z",
    "primaryContact": "John Smith",
    "billingEmail": "billing@acme-corp.com",
    "active": true,
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-06-20T14:45:00Z",
    "stats": {
      "userCount": 25,
      "activeUsers": 20,
      "deviceCount": 150,
      "activeDevices": 120,
      "deploymentCount": 42,
      "runningDeployments": 35
    }
  }
]

401

Unauthorized

403

Forbidden - Super Admin required