# Get Amazon Buy Box statistics for time range

Provides latest Amazon Buy Box statistics, i.e., whether a
- product is in Amazon Buy Box for Prime users
- product is in Amazon Buy Box for Non-Prime users
per product per Amazon domain for a given time range.


Endpoint: GET /api/v3/vendor/contracts/{contractId}/products/amazon/buybox/stats
Version: 0.0.7224
Security: BasicAuth, BearerAuth

## Path parameters:

  - `contractId` (string, required)
    Unique identifier of the contract
    Example: "qbcxvb"

## Query parameters:

  - `startDate` (string)
    for data retrieval.

Format: ISO 8601 date-time in UTC (e.g., )


- If omitted and  is provided:  =  - 48 hours
- If both omitted: range is  to
    Example: "2024-01-15T00:00:00Z"

  - `endDate` (string)
    for data retrieval.

Format: ISO 8601 date-time in UTC (e.g., )


- If omitted and  is provided:  =  + 48 hours
- If both omitted: range is  to
    Example: "2024-01-16T23:59:59Z"

  - `start` (integer)
    Where to start fetching the Amazon Buy Box statistics. Must be positive. Default value is 0.

  - `limit` (integer)
    Maximum number of results. Must be positive and not bigger than 50,000. Default value is 50,000.
    Example: 50000

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.productId` (number, required)
    Internal product identifier

  - `data.isInPrimeBuybox` (boolean, required)
    Indicates if product is Amazon Prime product and is in Amazon Buybox

  - `data.isInNonPrimeBuybox` (boolean, required)
    Indicates if product is in Amazon Buybox

## Response 400 fields (application/json):

  - `errors` (array, required)
    List of errors that occurred during request processing
    Example: [{"code":"request.invalid","message":"The provided request data is invalid"},{"code":"resource.invalid","message":"The requested resource could not be found"}]

  - `errors.code` (string, required)
    Machine-readable error code for programmatic error handling.
Typically follows a structured format like 'request.invalid' or 'resource.invalid'.
    Example: "request.invalid"

  - `errors.message` (string, required)
    Human-readable error message providing details about the issue
    Example: "The provided email address is not in a valid format"