Get current offers for a marketplace catalog item

GET /2024-09/marketplaces/catalog-items/{marketplace_catalog_item}/current-offers

Default

Returns the latest offers for a catalog item, excluding any where no_longer_visible_at is set

Path parameters

marketplace_catalog_item string(uuid) Required

The ID of the marketplace catalog item

Responses

200 application/json

Current offers for the catalog item
Hide response attribute Show response attribute object
- data array[object] Required
  
  Hide data attributes Show data attributes object
  
  price object Required
  
  The price of the item with currency
  
  Additional properties are NOT allowed.
  
  Hide price attributes Show price attributes object
  
  value number Required
  
  The numeric value of the price
  
  Minimum value is 0.
  
  currency string Required
  
  The currency code (e.g., USD, EUR)
  
  condition string Required
  
  The condition of the item
  
  shipping_price object | null
  
  Additional properties are NOT allowed.
  
  Hide shipping_price attributes Show shipping_price attributes object | null
  
  value number Required
  
  The numeric value of the shipping price
  
  Minimum value is 0.
  
  currency string Required
  
  The currency code (e.g., USD, EUR)
  
  is_fulfilled_by_marketplace boolean Required
  
  Whether the item is fulfilled by the marketplace
  
  marketplace_seller_id string | null
  
  The marketplace seller ID
  
  is_featured boolean Required
  
  Whether this is a featured offer
401
404

GET /2024-09/marketplaces/catalog-items/{marketplace_catalog_item}/current-offers

curl \
 --request GET 'https://app.merchanthq.com/api/2024-09/marketplaces/catalog-items/{marketplace_catalog_item}/current-offers' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": [
    {
      "price": {
        "value": 42.0,
        "currency": "string"
      },
      "condition": "string",
      "shipping_price": {
        "value": 42.0,
        "currency": "string"
      },
      "is_fulfilled_by_marketplace": true,
      "marketplace_seller_id": "string",
      "is_featured": true
    }
  ]
}