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",
      "details": "string",
      "message": "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.

errorsobjectOptional

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error