Get Feature Adoption Summary
GET/api/feature-adoption/summary
Returns adoption KPIs and the status of every feature for the window.
reports:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Statuses: active (used in the last 30 days), lapsed (used in the last 180 days but not 30), set_up (configured but never used), not_started, not_for_us (hidden by an admin), not_available (not on the plan / module disabled).
features_relevant excludes not_for_us and not_available. as_of is when statuses were last computed (nightly); has_data is false before the first computation. auto_cleared lists hidden features that were restored automatically because they started being used (last 30 days). can_manage tells whether the caller may hide/restore features.
Authentication: Requires Bearer token with the reports scope.
Each feature's preference (null unless the feature is marked "Not for us") carries reason, reason_label, note, marked_at, marked_by (user id) and marked_by_name — the display name of whoever marked it: "SKU.io support" when marked by SKU.io staff, "Former user" when the user no longer exists.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.