---
title: "The brand's store changes in the last `days` days (1–84), a page at a time, newest first or by the largest price move, optionally one kind: new, price_cut, price_raise, unavailable (a variant became not purchasable) or gone (no longer listed). Each carries its product's page and image. meta.count is every change that matches."
method: GET
path: "/v1/brands/{brandId}/store/changes"
tags: ["brands"]
---

# The brand's store changes in the last \`days\` days (1–84), a page at a time, newest first or by the largest price move, optionally one kind: new, price_cut, price_raise, unavailable (a variant became not purchasable) or gone (no longer listed). Each carries its product's page and image. meta.count is every change that matches.

`GET /v1/brands/{brandId}/store/changes`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/brands/{brandId}/store/changes`
- Auth: HTTP bearer

The brand's store changes in the last `days` days (1–84), a page at a time, newest first or by the largest price move, optionally one kind: new, price_cut, price_raise, unavailable (a variant became not purchasable) or gone (no longer listed). Each carries its product's page and image. meta.count is every change that matches. Scope `brands:read`; cache `daily`.

## Path parameters

- `brandId` union, required
  - string, uuid
  - string

## Query parameters

- `limit` integer
- `cursor` string
- `days` integer
- `change` 'new' | 'price_cut' | 'price_raise' | 'unavailable' | 'gone'
- `sort` 'newest' | 'largest_move'

## Response `200`

A page; `meta.cursor` is present when more follow.

- object
  - `data` object[], required
    - `kind` 'first_seen_in_catalog' | 'listed_price_changed' | 'available_flag_changed' | 'no_longer_observed_in_catalog', required
    - `product_id` string, required
    - `product_title` string, required
    - `variant_id` string, nullable, required
    - `variant_title` string, nullable, required
    - `observed_at` string, date-time, required
    - `before` string, nullable, required
    - `after` string, nullable, required
    - `product_url` string, nullable, required
    - `image_url` string, nullable, required
  - `meta` object, required
    - `request_id` string, required
    - `as_of` string, date-time, required
    - `lag_hours` number
    - `cursor` string
    - `count` integer

## Other responses

- `4XX`: The one error shape.
- `5XX`: The one error shape.

---

[API](https://skmtc.dev/scrollstash/apis/storequant-api.md) · [All operations](https://skmtc.dev/scrollstash/apis/storequant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrollstash/apis/storequant-api/revisions/4d67a114a13c?raw)