Get aggregate repricer history statistics for the team

Returns aggregated statistics about repricer history across all products in the team.
This includes metrics like total repricing runs, average price change percentage, success rate, and common error types.
Optional query parameters can be used to filter stats by date range or product category.

Use this endpoint to analyze overall repricer performance, identify trends, and monitor outcomes.

Related endpoints:

Use /history to get detailed history for a product.

Use /products endpoints to manage products.

Key properties in the response:

period: Date range for the stats.

products: Counts by priority and price update status.

operations: Totals, breakdowns by type/status, success rate.

prices: Average and total price changes.

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 HistoryStats schema for details.

Bodyapplication/json

Example

{
    "period": {
        "from": "2026-01-01",
        "to": "2026-07-01"
    },
    "products": {
        "total": 100,
        "by_priority": {
            "regular": 80,
            "paused": 20
        },
        "by_amazon_price_update_enabled": {
            "enabled": 90,
            "disabled": 10
        }
    },
    "operations": {
        "total": 500,
        "by_type": {
            "regular": 200,
            "paused": 300
        },
        "by_status": {
            "PRICE_SKIPPED_OUT_OF_BOUNDS": 50,
            "PRICE_ALREADY_OPTIMAL": 100,
            "PRICE_UPDATE_SUBMITTED": 300,
            "FAILED": 50
        },
        "success_rate": "96.00"
    },
    "prices": {
        "avg_change": "1.25",
        "avg_rise": "1.50",
        "avg_drop": "0.75",
        "total_drop": "50.00",
        "total_rise": "75.00"
    }
}

🟠400BadRequest

🟠402PaymentRequired

🟠403AccessDenied

🟠404NotFound

🟠422BusinessLogicError

🟠429TooManyRequests