Get price history for a marketplace catalog item

GET /2024-09/marketplaces/catalog-items/{marketplace_catalog_item}/price-history

Returns historical price data for a catalog item with the specified granularity

Path parameters

  • marketplace_catalog_item string(uuid) Required

    The ID of the marketplace catalog item

Query parameters

  • from string(date) Required

    Start date for the price history (inclusive)

  • to string(date) Required

    End date for the price history (inclusive)

  • granularity string Required

    The granularity of the price history data

    Values are day, week, or month.

Responses

  • 200 application/json

    Price history for the catalog item

    Hide response attribute Show response attribute object
    • data array[object] Required
      Hide data attributes Show data attributes object
      • from string(date) Required

        Start date of this period

      • to string(date) Required

        End date of this period

      • lowest_fulfilled_by_marketplace_price object | null

        Additional properties are NOT allowed.

        Hide lowest_fulfilled_by_marketplace_price attributes Show lowest_fulfilled_by_marketplace_price attributes object | null
        • value number Required

          The numeric value of the price

          Minimum value is 0.

        • currency string Required

          The currency code (e.g., USD, EUR)

      • highest_fulfilled_by_marketplace_price object | null

        Additional properties are NOT allowed.

        Hide highest_fulfilled_by_marketplace_price attributes Show highest_fulfilled_by_marketplace_price attributes object | null
        • value number Required

          The numeric value of the price

          Minimum value is 0.

        • currency string Required

          The currency code (e.g., USD, EUR)

      • lowest_fulfilled_by_merchant_price object | null

        Additional properties are NOT allowed.

        Hide lowest_fulfilled_by_merchant_price attributes Show lowest_fulfilled_by_merchant_price attributes object | null
        • value number Required

          The numeric value of the price

          Minimum value is 0.

        • currency string Required

          The currency code (e.g., USD, EUR)

      • highest_fulfilled_by_merchant_price object | null

        Additional properties are NOT allowed.

        Hide highest_fulfilled_by_merchant_price attributes Show highest_fulfilled_by_merchant_price attributes object | null
        • value number Required

          The numeric value of the price

          Minimum value is 0.

        • currency string Required

          The currency code (e.g., USD, EUR)

  • 401
  • 404
GET /2024-09/marketplaces/catalog-items/{marketplace_catalog_item}/price-history
curl \
 --request GET 'https://app.merchanthq.com/api/2024-09/marketplaces/catalog-items/{marketplace_catalog_item}/price-history?from=2025-05-04&to=2025-05-04&granularity=day' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "data": [
    {
      "from": "2025-05-04",
      "to": "2025-05-04",
      "lowest_featured_price": {
        "value": 42.0,
        "currency": "string"
      },
      "highest_featured_price": {
        "value": 42.0,
        "currency": "string"
      },
      "lowest_fulfilled_by_marketplace_price": {
        "value": 42.0,
        "currency": "string"
      },
      "highest_fulfilled_by_marketplace_price": {
        "value": 42.0,
        "currency": "string"
      },
      "lowest_fulfilled_by_merchant_price": {
        "value": 42.0,
        "currency": "string"
      },
      "highest_fulfilled_by_merchant_price": {
        "value": 42.0,
        "currency": "string"
      }
    }
  ]
}