List repricing history - Seller Assistant API

Lists the repricing runs of the team, the newest first.

The history keeps the runs of the last 32 days only. Without from_date, to_date or period, the list gives the last 32 days. An older from_date starts at the 32-day limit.

A run has the old and the final price, the status, the strategy, the limits, the market data and the mode in effect.

Statuses

PRICE_UPDATE_SUBMITTED: the run sent the new price to Amazon.

PRICE_ALREADY_OPTIMAL: the price of the seller is the target price.

PRICE_SKIPPED_OUT_OF_BOUNDS: the target price is outside the limits, so the run sent no price.

PRICE_UPDATE_SKIPPED_BY_ALLOW_FLAG: the price is correct, but a setting stops the update.

DRY_RUN_PRICE_UPDATE_EMULATED: the mode is dry, so the run sent no price to Amazon.

SKIPPED: the run stopped on an expected condition. error_code gives the reason, for example MISSING_COST_DATA_FOR_ECONOMICS_RULE.

FAILED: the run stopped on an error. error_code gives the reason.

PRICE_UPDATE_CONFIRMED: Amazon confirmed the price. The repricer does not write this status yet.

Error codes of a failed run

FAILED_TO_LOAD_REPRICER_PRODUCT: the repricer could not load the settings of the product.

NO_REPRICER_PRODUCT_FOUND: the repricer has no such product for the team.

FAILED_TO_RESOLVE_STRATEGY: the repricer could not load the strategy.

FAILED_TO_RESOLVE_AMAZON_SELLER_CONTEXT: the repricer could not find the seller account for the marketplace.

NO_AMAZON_SELLER_AUTHORIZATION_FOUND: the Amazon account of the seller is not connected.

FAILED_TO_FETCH_SELLER_PRICE_FROM_AMAZON: Amazon did not give the price of the seller.

REPRICER_PRODUCT_PAUSED: the product is paused.

NO_SELLER_LISTINGS_FOUND_ON_AMAZON: Amazon has no listing of the seller for the product.

INACTIVE_SELLER_LISTING: the listing is inactive.

NO_SELLER_PRICE_FOUND_ON_AMAZON_LISTINGS: the listing has no usable price.

FAILED_TO_FETCH_COMPETITIVE_PRICING_FROM_AMAZON: Amazon did not give the market data.

NO_LOWEST_PRICED_OFFERS_FOUND: the market data has no lowest-priced offers.

NO_COMPETITIVE_PRICE_FOUND: the market data has no competitive price.

CURRENCY_MISMATCH_BETWEEN_LISTING_AND_MARKET_DATA: the listing and the market data have different currencies.

FAILED_TO_CALCULATE_TARGET_PRICE: the strategy could not calculate the target price.

FAILED_TO_SUBMIT_PRICE_TO_AMAZON: Amazon did not accept the price.

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,
            "asin": "B00TEST123",
            "marketplace_id": "ATVPDKIKX0DER",
            "sku": "SKU-123",
            "reprice_priority": "regular",
            "status": "FAILED",
            "error_code": null,
            "market_data": {
                "lowest_buybox_price": {
                    "price": "25.99",
                    "currency": "USD"
                }
            },
            "settings_snapshot": {},
            "strategy": "follow_buybox",
            "strategy_params": {
                "price_adjustment": "-0.01",
                "price_adjustment_type": "amount"
            },
            "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"
            ],
            "mode": "off",
            "amazon_submit_price_status": "ACCEPTED",
            "amazon_submit_price_submission_id": "1234567890",
            "amazon_submit_price_blocking_issues": [],
            "created_at": "2024-03-27T12:34:56Z"
        }
    ],
    "meta": {
        "pagination": {
            "page": 1,
            "per_page": 50,
            "total": 100,
            "last_page": 2
        },
        "trial_limit": {
            "max_rows": 25,
            "total": 137,
            "code": "trial_list_limited",
            "message": "The trial shows only the first rows of a list. Subscribe to see all rows.",
            "subscribe_url": "https://app.sellerassistant.app/subscription"
        }
    }
}

🟠400BadRequest

🟠402PaymentRequired

🟠403AccessDenied

🟠404NotFound

🟠422BusinessLogicError

🟠429TooManyRequests

🔴503ServiceUnavailable