Sign in

v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-013764062.2 MB
Instance Admin

Instance usage statistics

Provides statistics about various features of Unleash to allow for reporting of usage for self-hosted customers. The response contains data such as the number of users, groups, features, strategies, versions, etc.

get/api/admin/instance-admin/statistics

Response

instanceAdminStatsSchema

instanceIdstring required

A unique identifier for this instance. Generated by the database migration scripts at first run. Typically a UUID.

timestampstring date-time nullable

When these statistics were produced

versionOSSstring

The version of Unleash OSS that is bundled in this instance

versionEnterprisestring

The version of Unleash Enterprise that is bundled in this instance

usersinteger

The number of users this instance has

licensedUsersinteger

The number of users who had access to Unleash within the last 30 days, including those who may have been deleted during this period.

featureTogglesinteger

The number of feature-toggles this instance has

projectsinteger

The number of projects defined in this instance.

contextFieldsinteger

The number of context fields defined in this instance.

rolesinteger

The number of roles defined in this instance

groupsinteger

The number of groups defined in this instance

environmentsinteger

The number of environments defined in this instance

segmentsinteger

The number of segments defined in this instance

strategiesinteger

The number of strategies defined in this instance

SAMLenabledboolean

Whether or not SAML authentication is enabled for this instance

OIDCenabledboolean

Whether or not OIDC authentication is enabled for this instance

featureExportsinteger

The number of export operations on this instance

featureImportsinteger

The number of import operations on this instance

maxEnvironmentStrategiesinteger

The highest number of strategies used on a single feature flag in a single environment.

maxConstraintsinteger

The highest number of constraints used on a single strategy.

maxConstraintValuesinteger

The highest number of constraint values used on a single constraint.

releaseTemplatesinteger

The number of release templates in this instance

releasePlansinteger

The number of release plans in this instance

edgeInstanceUsageobject

The average number of edge instances, per month, in the last 12 months, rounded to 3 decimal places

readOnlyUsersinteger

The number of ReadOnly users in this instance

sumstring

A SHA-256 checksum of the instance statistics to be used to verify that the data in this object has not been tampered with

Example response

{
  "instanceId": "ed3861ae-78f9-4e8c-8e57-b57efc15f82b",
  "timestamp": "2023-06-12T12:25:06Z",
  "versionOSS": "5.1.7",
  "versionEnterprise": "5.1.7",
  "users": 8,
  "previousDayMetricsBucketsCount": {
    "enabledCount": 10,
    "variantCount": 10
  },
  "activeUsers": {
    "last7": 5,
    "last30": 10,
    "last60": 12,
    "last90": 15
  },
  "licensedUsers": 10,
  "productionChanges": {
    "last30": 10,
    "last60": 12,
    "last90": 15
  },
  "featureToggles": 47,
  "projects": 3,
  "contextFields": 7,
  "roles": 5,
  "groups": 12,
  "environments": 3,
  "segments": 19,
  "strategies": 8,
  "OIDCenabled": true,
  "clientApps": [
    {
      "range": "30d",
      "count": 1
    }
  ],
  "apiTokens": {
    "admin": 5,
    "client": 5,
    "frontend": 5
  },
  "maxEnvironmentStrategies": 3,
  "maxConstraints": 4,
  "maxConstraintValues": 17,
  "releaseTemplates": 2,
  "releasePlans": 1,
  "edgeInstanceUsage": {
    "2025-09": 2.25,
    "2025-08": 1.75,
    "2024-10": 0.45
  },
  "readOnlyUsers": 1,
  "sum": "b023323477abb1eb145bebf3cdb30a1c2063e3edc1f7ae474ed8ed6c80de9a3b"
}