Get repricer history for a product (all repricing runs)

Returns the repricer history for a specific product, identified by its repricer_product_id.
The history includes details of each repricing run, such as old price, new price, strategy used, and outcome.
Optional query parameters allow filtering by date range and status.

Use this endpoint to audit repricing actions, debug issues, or analyze performance for a product.

Related endpoints:

Use /products endpoints to manage products.

Use /history/stats for aggregate statistics.

Key properties in each history item:

old_price, final_price: Price before and after repricing.

status: Outcome of the repricing run.

strategy, limits: Settings used for this run.

market_data: Competitor and market context.

amazon_price_update_enabled: Whether a price update was allowed to be sent to Amazon (actual send is reflected in status).

Reprice status notes:

Successful/final statuses:

PRICE_SKIPPED_OUT_OF_BOUNDS: Target price is outside configured limits, so update is skipped.

PRICE_ALREADY_OPTIMAL: Current seller price already matches the calculated target.

PRICE_UPDATE_SKIPPED_BY_ALLOW_FLAG: Calculated price is valid, but Amazon update is disabled by flag/settings.

PRICE_UPDATE_SUBMITTED: New price was submitted to Amazon.

PRICE_UPDATE_CONFIRMED: Submitted price was confirmed by Amazon. (not implemented yet)

FAILED: Repricing flow terminated with an error.

Failed error_code values (used when status=FAILED):

FAILED_TO_LOAD_REPRICER_PRODUCT: System failed to load product configuration for repricing.

NO_REPRICER_PRODUCT_FOUND: Product was not found in repricer storage for this team.

FAILED_TO_RESOLVE_STRATEGY: Could not resolve or initialize repricing strategy.

FAILED_TO_RESOLVE_AMAZON_SELLER_CONTEXT: Could not resolve seller/market context for Amazon calls.

NO_AMAZON_SELLER_AUTHORIZATION_FOUND: Missing Amazon authorization for seller account.

FAILED_TO_FETCH_SELLER_PRICE_FROM_AMAZON: Failed to fetch current seller price from Amazon.

REPRICER_PRODUCT_PAUSED: Product is paused and cannot be repriced.

NO_SELLER_LISTINGS_FOUND_ON_AMAZON: No listing records found for seller/product on Amazon.

INACTIVE_SELLER_LISTING: Listing exists but is inactive.

NO_SELLER_PRICE_FOUND_ON_AMAZON_LISTINGS: Listing exists but no usable seller price was found.

FAILED_TO_FETCH_COMPETITIVE_PRICING_FROM_AMAZON: Failed to fetch competitive pricing/market data.

NO_LOWEST_PRICED_OFFERS_FOUND: Competitive data returned no lowest-priced offers.

NO_COMPETITIVE_PRICE_FOUND: Competitive price could not be resolved from market data.

CURRENCY_MISMATCH_BETWEEN_LISTING_AND_MARKET_DATA: Listing currency differs from market data currency.

FAILED_TO_CALCULATE_TARGET_PRICE: Strategy failed to calculate target price.

FAILED_TO_SUBMIT_PRICE_TO_AMAZON: Price submission to Amazon failed.

API Key

Add parameter in query

api_key

Example:

api_key: ********************

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Successful response. See HistorySearchResponse schema for details.

Bodyapplication/json

Example

{
    "data": [
        {
            "id": 101,
            "repricer_product_id": 1,
            "asin": "B00TEST123",
            "marketplace_id": "ATVPDKIKX0DER",
            "sku": "SKU-123",
            "reprice_priority": "regular",
            "status": "PRICE_UPDATE_SUBMITTED",
            "error_code": null,
            "market_data": {
                "lowest_buybox_price": {
                    "price": "25.99",
                    "currency": "USD"
                }
            },
            "settings_snapshot": {},
            "strategy": "follow_buybox",
            "strategy_params": {
                "beat_by": "0.01"
            },
            "limits": {
                "min_price": "5.00",
                "max_price": "80.00"
            },
            "old_price": "24.99",
            "currency": "USD",
            "price_before_limits": "25.49",
            "should_update_before_limits": true,
            "reason_before_limits": "PRICE_CHANGED",
            "final_price": "25.99",
            "should_update_after_limits": true,
            "reason_after_limits": "PRICE_UPDATE_SUBMITTED",
            "limits_applied": [
                "max_change_percent",
                "min_price"
            ],
            "amazon_price_update_enabled": true,
            "amazon_submit_price_status": "ACCEPTED",
            "amazon_submit_price_submission_id": "1234567890",
            "amazon_submit_price_blocking_issues": [],
            "created_at": "2024-03-27T12:34:56Z"
        }
    ],
    "pagination": {
        "current_page": 1,
        "per_page": 50,
        "total": 100,
        "last_page": 2
    }
}

🟠400BadRequest

🟠402PaymentRequired

🟠403AccessDenied

🟠404NotFound

🟠422BusinessLogicError

🟠429TooManyRequests