JSON API – GET Fetch Walmart Listings

Overview

This endpoint retrieves Walmart listings managed through Feedvisor.

Common API behavior such as authentication, pagination, response envelope, and query operators is documented in:

JSON API – Listings (Overview & Common Concepts)

This article documents the Walmart-supported fields and indicates whether each field is:

• writable – supported as persistable

• read-only – returned by the API but not persistable

---

Endpoint

GET /external/{accountId}/v2/listings

Example

https://api-gateway.feedvisor.com/external/1234/v2/listings

---

Walmart Field Support

Writable Fields

These fields are persistable.

Field	Access	Description
brand	writable	Product brand
repricerStrategy	writable	Repricing strategy
repriced	writable	Indicates whether the item is repriced
floorPrice	writable	Repricing floor price
ceilingPrice	writable	Repricing ceiling price
repricingTargetOosd	writable	Repricing target OOSD setting
repricingTargetVelocity	writable	Repricing target velocity
repricerMethod	writable	Repricing method
fixedPrice	writable	Fixed listing price
referenceAccountId	writable	Reference account ID
referenceSKU	writable	Reference SKU
referenceASIN	writable	Reference ASIN
referenceFulfillmentChannel	writable	Reference fulfillment channel
referencePriceChange	writable	Reference price change
cohort	writable	Cohort
vat	writable	VAT
shippingCost	writable	Shipping cost
markup	writable	Markup
additionalSellingCosts	writable	Additional selling costs
comment	writable	Listing comment
cost	writable	Product cost
isbn	writable	ISBN
ean	writable	EAN
mpn	writable	Manufacturer part number
vendorName	writable	Vendor name
vendorPartNumber	writable	Vendor part number
leadTime	writable	Lead time
unitsInPacks	writable	Units in pack
minQuantityForOrder	writable	Minimum quantity for order
parentSKU	writable	Parent SKU
daysOfCoverage	writable	Days of coverage
isReplenishable	writable	Replenishable flag
warehouseInventory	writable	Warehouse inventory

---

Read-Only Fields

These fields are returned by the API but are not persistable.

Field	Access	Description
buyBoxEligible	read-only	Whether the item is Buy Box eligible
buyBoxItemPrice	read-only	Buy Box item price
buyBoxShippingPrice	read-only	Buy Box shipping price
currency	read-only	Currency code
fulfillmentType	read-only	Fulfillment type
gtin	read-only	Global trade item number
itemId	read-only	Walmart item ID
itemPageUrl	read-only	Walmart item page URL
lifecycleStatus	read-only	Listing lifecycle status
maximumSellerAllowedPrice	read-only	Maximum seller allowed price
minimumSellerAllowedPrice	read-only	Minimum seller allowed price
msrp	read-only	MSRP
offerEndDate	read-only	Offer end date
offerStartDate	read-only	Offer start date
price	read-only	Current listing price
primaryCategoryPath	read-only	Primary category path
primaryImageUrl	read-only	Primary image URL
primaryVariant	read-only	Indicates primary variant
productCategory	read-only	Product category
productName	read-only	Product name
productTaxCode	read-only	Product tax code
publishStatus	read-only	Publish status
reviewsCount	read-only	Review count
searchable	read-only	Searchable indicator
shelfName	read-only	Shelf name
shipMethods	read-only	Shipping methods
shippingWeight	read-only	Shipping weight
shippingWeightUnit	read-only	Shipping weight unit
sku	read-only	Seller SKU
statusChangeReason	read-only	Status change reason
upc	read-only	UPC
variantGroupId	read-only	Variant group ID
variantGroupingAttributes	read-only	Variant grouping attributes
variantGroupingValues	read-only	Variant grouping values
wfsSalesRestriction	read-only	Walmart Fulfillment Services sales restriction
wpid	read-only	Walmart product ID
inventoryAvailToSellQuantity	read-only	Inventory available to sell quantity
wfsAvailableUnits	read-only	Walmart Fulfillment Services available units
condition	read-only	Item condition
dependentPriceCalculationType	read-only	Dependent price calculation type
fulfillmentChannel	read-only	Fulfillment channel
quantity	read-only	Quantity

---

Example Request

GET /external/1234/v2/listings?sku=[BW:WM]&brand=[EQCS:Acme]&price=[GTE:20]
Authorization: Bearer YOUR_TOKEN

---

Example Response

{
  "totalItemsCount": 2,
  "totalPagesCount": 1,
  "page": 0,
  "items": [
    {
      "sku": "WM-4321",
      "itemId": "123456789",
      "productName": "Acme Blender",
      "brand": "Acme",
      "price": 29.99,
      "currency": "USD",
      "publishStatus": "PUBLISHED",
      "inventoryAvailToSellQuantity": 12,
      "condition": "NEW",
      "floorPrice": 25.00,
      "ceilingPrice": 35.00,
      "cost": 14.20
    },
    {
      "sku": "WM-1234",
      "itemId": "987654321",
      "productName": "Acme Toaster",
      "brand": "Acme",
      "price": 24.99,
      "currency": "USD",
      "publishStatus": "PUBLISHED",
      "inventoryAvailToSellQuantity": 6,
      "condition": "NEW",
      "floorPrice": 20.00,
      "ceilingPrice": 30.00,
      "cost": 11.75
    }
  ]
}

---

Notes

Access semantics

• writable means the field is persistable

• read-only means the field may be returned by the API but is not persistable

Filtering

Walmart listings use the same filtering syntax and query operators described in the common Listings API article.

Response shape

The response envelope is the same as other listings endpoints:

• totalItemsCount

• totalPagesCount

• page

• items