List Product Lifecycle History
GET/api/v2/products/:product/lifecycle/transitions
A product's full lifecycle history, newest first, paginated (10 per page by default, up to 200). Each entry says whether it can still be undone.
products:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Query parameters (all optional): page, per_page (1–200), search (partial match on note, reason or source), state (entries whose from_state or to_state is this state key).
Response fields per entry: id, product_id, from_state, from_state_label, to_state, to_state_label, reason (brand_decision, supplier_discontinued, seasonal_end, low_performance, replaced, quality_issue, other), reason_label, note, source (manual, bulk, import, api, scheduled, sell_out, stock_returned, automation, suggestion, undo, season_end, cascade), source_label, user {id, name} (null for system changes), on_hand_units and on_hand_value (stock at the time), tracked_job_id (the bulk job, if any), created_at, undone_at, undoable, details.
details is what the system did on that change, or null when there is nothing to show:
- sell_out (or null): the sell-out run behind a sell_out entry - action and action_label (keep, end, end_and_archive, delete), archived (the product was archived), kept (listings kept live at zero), failed (retries were exhausted), aborted (the run was stopped), not_archived_reason (why the product was not archived, or null), and listings [{product_listing_id, integration_instance_id, channel, action, action_label, outcome (ended, skipped, pending, failed), outcome_label (Ended, Deleted, Kept live at zero, Skipped, Waiting for the channel to confirm quantity 0, Failed), message, reached_end_state}]
- stock_returned (or null): on a stock_returned entry - units_returned, unarchived (the product was unarchived), relisted (ended listings were relisted)
- sell_out_cancelled: [{at, reason}] - every sell-out action cancelled because stock came back before it ran
Requires a Bearer token with the products read/write scope and the products.show permission.
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Not Found
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.