Returns the lowest priced offers for a single item by Walmart Item ID

GET

/products/pricing/v4/items/:itemId/offers

GET

/seller/v1/products/pricing/v4/items/:itemId/offers

curl -G https://marketplace.walmart.com/seller/v1/products/pricing/v4/items/itemId/offers \
     -H "Authorization: Bearer <token>" \
     -d ItemCondition=New \
     -d MarketplaceId=MarketplaceId

{
  "payload": {
    "marketplaceId": "string",
    "ItemCondition": "New",
    "status": "string",
    "Identifier": {
      "MarketplaceId": "string",
      "ItemCondition": "New",
      "walmartItemId": "string",
      "SellerSKU": "string"
    },
    "Summary": {
      "TotalOfferCount": 1,
      "NumberOfOffers": [
        {
          "condition": "string",
          "fulfillmentChannel": "WFS",
          "OfferCount": 1
        }
      ],
      "LowestPrices": [
        {
          "condition": "string",
          "fulfillmentChannel": "WFS",
          "ListingPrice": {
            "CurrencyCode": "USD",
            "Amount": 1.1
          },
          "offerType": "B2C",
          "quantityTier": 1,
          "quantityDiscountType": "QUANTITY_DISCOUNT",
          "LandedPrice": {
            "CurrencyCode": "USD",
            "Amount": 1.1
          },
          "Shipping": {
            "CurrencyCode": "USD",
            "Amount": 1.1
          }
        }
      ],
      "BuyBoxPrices": [
        {
          "condition": "string",
          "LandedPrice": {
            "CurrencyCode": "USD",
            "Amount": 1.1
          },
          "ListingPrice": {
            "CurrencyCode": "USD",
            "Amount": 1.1
          },
          "Shipping": {
            "CurrencyCode": "USD",
            "Amount": 1.1
          },
          "offerType": "B2C",
          "quantityTier": 1,
          "quantityDiscountType": "QUANTITY_DISCOUNT",
          "sellerId": "string"
        }
      ],
      "ListPrice": {
        "CurrencyCode": "USD",
        "Amount": 1.1
      },
      "CompetitivePriceThreshold": {
        "CurrencyCode": "USD",
        "Amount": 1.1
      },
      "SuggestedLowerPricePlusShipping": {
        "CurrencyCode": "USD",
        "Amount": 1.1
      },
      "SalesRankings": [
        {
          "ProductCategoryId": "string",
          "Rank": 1
        }
      ],
      "BuyBoxEligibleOffers": [
        {
          "condition": "string",
          "fulfillmentChannel": "WFS",
          "OfferCount": 1
        }
      ],
      "OffersAvailableTime": "2024-01-15T09:30:00Z"
    },
    "Offers": [
      {
        "SubCondition": "string",
        "ShippingTime": {
          "minimumHours": 1,
          "maximumHours": 1,
          "availableDate": "string",
          "availabilityType": "NOW"
        },
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 1.1
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 1.1
        },
        "IsFulfilledByWFS": true,
        "MyOffer": true,
        "offerType": "B2C",
        "SellerId": "string",
        "ConditionNotes": "string",
        "SellerFeedbackRating": {
          "FeedbackCount": 1,
          "SellerPositiveFeedbackRating": 1.1
        },
        "quantityDiscountPrices": [
          {
            "quantityTier": 1,
            "quantityDiscountType": "QUANTITY_DISCOUNT",
            "listingPrice": {
              "CurrencyCode": "USD",
              "Amount": 1.1
            }
          }
        ],
        "ShipsFrom": {
          "State": "string",
          "Country": "string"
        },
        "WFSPrimeDetails": {
          "IsWFSPrime": true,
          "IsNationalWFSPrime": true
        },
        "IsBuyBoxWinner": true,
        "IsFeaturedMerchant": true
      }
    ],
    "walmartItemId": "string",
    "SKU": "string"
  },
  "errors": [
    {
      "code": "string",
      "message": "string",
      "details": "string"
    }
  ]
}

Returns the lowest priced offers for a single item based on Walmart Item ID and item condition.

Uses Walmart Item ID as the primary identifier per ADR-029 (ASIN not supported — no ASIN resolver exists in the Walmart platform; IQS queries by product.item_id).

Backed by IQS catalog_index cross-seller query (same as getListingOffers hop-2). Returns 404 when no offers are found for the given itemId.

Returns the lowest priced offers for a single item based on Walmart Item ID and item condition. Uses Walmart Item ID as the primary identifier per ADR-029 (ASIN not supported — no ASIN resolver exists in the Walmart platform; IQS queries by product.item_id). Backed by IQS catalog_index cross-seller query (same as getListingOffers hop-2). Returns 404 when no offers are found for the given itemId.

Path parameters

itemIdstringRequired

The Walmart Item ID of the item.

Query parameters

MarketplaceIdstringRequired

A marketplace identifier. Specifies the marketplace for which prices are returned.

ItemConditionenumRequired

Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

Allowed values:

CustomerTypeenumOptional

Indicates whether to request Consumer or Business offers. Default is Consumer.

Allowed values:

Response

Success

payloadobjectOptional

The payload for the getListingOffers and getItemOffers operations.

errorslist of objectsOptional

A list of error responses returned when a request is unsuccessful.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error