Developer Portal
Walmart Developer
HomeSDKsAPI ReferenceContext Plugin
PricingProduct Pricing

Returns the lowest priced offers for a batch of items by Walmart Item ID

POST
/batches/products/pricing/v4/itemOffers

Batch version of getItemOffers. Accepts up to 20 Walmart Item ID requests. Uses Walmart Item ID as the primary identifier.

Implemented as in-process fan-out over getItemOffers. Each item gets its own per-item HTTP status code in the response body; the outer HTTP response is always 200. Implemented: .

Authorization

sellerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

The request associated with the getItemOffersBatch API call.

requests?array<>

A list of getItemOffers batched requests to run.

Items1 <= items <= 20

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/batches/products/pricing/v4/itemOffers" \  -H "Content-Type: application/json" \  -d '{}'
{  "responses": [    {      "headers": {        "Date": "string",        "X-Request-Id": "string"      },      "status": {        "statusCode": 100,        "reasonPhrase": "string"      },      "body": {        "payload": {          "marketplaceId": "string",          "walmartItemId": "string",          "SKU": "string",          "ItemCondition": "New",          "status": "string",          "Identifier": {            "MarketplaceId": "string",            "walmartItemId": "string",            "SellerSKU": "string",            "ItemCondition": "New"          },          "Summary": {            "TotalOfferCount": 0,            "NumberOfOffers": [              {                "condition": "string",                "fulfillmentChannel": "WFS",                "OfferCount": 0              }            ],            "LowestPrices": [              {                "condition": "string",                "fulfillmentChannel": "WFS",                "offerType": "B2C",                "quantityTier": 0,                "quantityDiscountType": "QUANTITY_DISCOUNT",                "LandedPrice": {                  "CurrencyCode": "USD",                  "Amount": 0                },                "ListingPrice": {                  "CurrencyCode": "USD",                  "Amount": 0                },                "Shipping": {                  "CurrencyCode": "USD",                  "Amount": 0                }              }            ],            "BuyBoxPrices": [              {                "condition": "string",                "offerType": "B2C",                "quantityTier": 0,                "quantityDiscountType": "QUANTITY_DISCOUNT",                "LandedPrice": {                  "CurrencyCode": "USD",                  "Amount": 0                },                "ListingPrice": {                  "CurrencyCode": "USD",                  "Amount": 0                },                "Shipping": {                  "CurrencyCode": "USD",                  "Amount": 0                },                "sellerId": "string"              }            ],            "ListPrice": {              "CurrencyCode": "USD",              "Amount": 0            },            "CompetitivePriceThreshold": {              "CurrencyCode": "USD",              "Amount": 0            },            "SuggestedLowerPricePlusShipping": {              "CurrencyCode": "USD",              "Amount": 0            },            "SalesRankings": [              {                "ProductCategoryId": "string",                "Rank": 0              }            ],            "BuyBoxEligibleOffers": [              {                "condition": "string",                "fulfillmentChannel": "WFS",                "OfferCount": 0              }            ],            "OffersAvailableTime": "2019-08-24T14:15:22Z"          },          "Offers": [            {              "MyOffer": true,              "offerType": "B2C",              "SubCondition": "string",              "SellerId": "string",              "ConditionNotes": "string",              "SellerFeedbackRating": {                "SellerPositiveFeedbackRating": 0.1,                "FeedbackCount": 0              },              "ShippingTime": {                "minimumHours": 0,                "maximumHours": 0,                "availableDate": "string",                "availabilityType": "NOW"              },              "ListingPrice": {                "CurrencyCode": "USD",                "Amount": 0              },              "quantityDiscountPrices": [                {                  "quantityTier": 0,                  "quantityDiscountType": "QUANTITY_DISCOUNT",                  "listingPrice": {                    "CurrencyCode": "USD",                    "Amount": 0                  }                }              ],              "Shipping": {                "CurrencyCode": "USD",                "Amount": 0              },              "ShipsFrom": {                "State": "string",                "Country": "string"              },              "IsFulfilledByWFS": true,              "WFSPrimeDetails": {                "IsWFSPrime": true,                "IsNationalWFSPrime": true              },              "IsBuyBoxWinner": true,              "IsFeaturedMerchant": true            }          ]        },        "errors": [          {            "code": "string",            "message": "string",            "details": "string"          }        ]      },      "request": {        "uri": "string",        "method": "GET",        "headers": {},        "MarketplaceId": "string",        "ItemCondition": "New",        "CustomerType": "Consumer",        "walmartItemId": "string"      }    }  ]}

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

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(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 batch of SKU listings POST

Batch version of getListingOffers. Accepts up to 20 SKU requests. Implemented as in-process fan-out over getListingOffers (IQS-backed). Each SKU gets its own per-item HTTP status code in the response body; the outer HTTP response is always 200. Implemented: .