Get Lifecycle Suggestion Summary
GET/api/v2/product-lifecycle/suggestions/summary
Counts of open lifecycle suggestions, overall and per rule, plus each rule's effective configuration. Like the list, the first call for an account that has never generated suggestions queues the first run.
products:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Response fields:
- open_total: open suggestions on unarchived products
- by_rule: open count keyed by rule key (rules with none are omitted)
- banner.no_active_supplier_count: open suggestions where every supplier source is discontinued
- first_run: {generating (bool), message} - generating is true while the first run is still queued
- rules: every rule keyed by rule key with enabled (bool), params (rule parameters: dormant.days, cz_classification.consecutive, channel_inactive.days, successor_launched.min_units), label and suggested_state
Requires a Bearer token with the products read/write scope and the products.index permission.
Request
Responses
- 200
- 401
- 403
- 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.
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.