The Items API from Walmart — 13 operation(s) for items.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/walmart-items-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Walmart Items API
version: '1.0'
description: 'Operations tagged Items across 2 of this provider''s published API definitions: walmart-dropship-vendor-items-openapi-original.yml, walmart-marketplace-items-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api-gateway.walmart.com
description: Production URL
- url: https://sandbox.walmartapis.com
description: Sandbox URL
- url: https://marketplace.walmartapis.com
description: Production URL
tags:
- name: Items
paths:
/v3/feeds:
post:
tags:
- Items
operationId: itemBulkUploads
summary: Walmart Maintain Items in Bulk
description: "<a id=\"Post_Bulk_Item_Upload\" style=\"color:red; font-size:larger\">POST <baseUrl>/v3/feeds</a>\n\nThis feed request sets up and maintains items in bulk. \n\nUse the relevant feed file type and review the feed file structure overview provided in the <a href=\"https://developer.walmart.com/doc/us/us-supplier/us-supplier-items/\" target=\"_blank\">Items Guide</a>. \n\nOnce the feed file is built, pass the attached file using the **Supplier Feed** request. Select the relevant product type, category, or supply chain item type as part of the submission process. For example, if setting up a Blu-ray disc™, use the **Movies** product type to define all of the required attributes.\n\nThis is an asynhronous (async) request, or a web service where users can carry out multiple requests simultaneously. Receiving a success response does not mean the feed file is processed successfully. Continue to track the status of the feed file by its `feedId` received from the **Feed Status** request.\n"
parameters:
- name: feedType
in: query
description: "Specifies the feed file that will be used and the action the user is intending. \n\nValid values are:\n\n| Value | Meaning |\n| --- | ----------- |\n| OMNI_DSV_ITEM | Feed type for Drop Ship Vendor (DSV) item submission. |\n| OMNI_MAINTENANCE | Feed type to maintain any item. |\n| OMNI_ONLINE_ITEM | Feed type for Walmart-owned online (eCommerce) and Walmart-owned store or store and eCommerce item submission. |\n"
required: true
schema:
type: string
example: OMNI_ONLINE_ITEM
- in: header
name: Accept
required: false
schema:
type: string
description: 'Specifies the data type expected in a response sent from the server.
Valid values are:
| Value | Meaning |
| --- | --- |
| application/json | JSON format for data returned in response. |
| application/xml | XML format for data returned in response. |
'
example: application/xml
- in: header
name: WM_CONSUMER.CHANNEL.TYPE
required: false
schema:
type: string
description: 'Specifies an identifier that tracks the consumer request by channel.
Use the consumer channel type received during onboarding.
Contact the system administrator or developer management for the `WM_CONSUMER.CHANNEL.TYPE` value.
'
example: 0f3e4dd4-0514-4346-b39d-…
- in: header
name: WM_QOS.CORRELATION_ID
required: true
schema:
type: string
description: "Specifies an identifier for each API call and is used to track and debug issues.\n\nThis may be any value, but cannot be null or omitted. \n"
example: 6474-a253
- in: header
name: WM_SEC.ACCESS_TOKEN
required: true
schema:
type: string
description: 'Specifies the access token retrieved in the <a href="https://developer.walmart.com/api/us/supplier/auth#operation/dsvTokenAPI">Create Access Token</a> request.
This value is required for token-based authentication.
'
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM…
- in: header
name: Content-Type
required: true
schema:
type: string
description: "Specifies the format of request and response body data. \n\nIt specifies if the payload is JSON, XML, form data, or other data type. \nSetting `Content-Type` appropriately is essential when exchanging formatted data with APIs.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| application/json | JSON format for request and response body data. |\n| multipart/form-data | Multipart form data format for request and response body data. |\n"
example: application/json
requestBody:
description: Request fields
content:
application/json:
schema:
required:
- file
type: object
properties:
file:
type: string
description: 'Specifies the feed file to upload.
For a detailed feed file structure overview, reference the <a href="https://developer.walmart.com/doc/us/us-supplier/us-supplier-items/" target="_blank">Items Guide</a>.
'
format: binary
examples:
OMNI_ONLINE_ITEM:
value:
SupplierItemFeedHeader:
businessUnit: WALMART_US
locale: en
version: 5.0.20230731-22_03_36-api
SupplierItem:
- Orderable:
batteryTechnologyType: Does Not Contain a Battery
productId: 06248911077085
electronicsIndicator: 'No'
rppc: 'No'
price: 2
isPrivateLabelOrUnbranded: 'No'
chemicalAerosolPesticide: 'No'
shipsInOriginalPackaging: 'No'
Visible:
Candy Corn:
occasion:
- Birthday
california_state_chemical_warning_text: None
container_material:
- Beta
keyFeatures:
- Test123
- Test123
- Test123
condition: New
productName: Butter Finge Candy 11ozChoc123
food_condition:
- Frozen
manufacturer: CandyMan
pieceCount: 2
countPerPack: 10
multipackQuantity: 10
isProp65WarningRequired: 'No'
netContent:
productNetContentMeasure: 10
productNetContentUnit: Fluid Ounces
foodForm:
- Balls
ib_retail_packaging: Bundle
brand: Butter Finger
mainImageUrl: https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
servingSize: small
servingsPerContainer: '2'
productSecondaryImageURL:
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
containerType:
- Bag
texture:
- liquid
count: 10
sizeDescriptor: Full Size
shortDescription: http://walmart.com
flavor: caramel
size: Size
ingredientListImage: https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
nutritionFactsLabel: https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
TradeItem:
countryOfOriginAssembly:
- US - United States
productId: 06248911077085
isBreakPack: 'No'
supplierId: '123456789'
factoryId:
- None
unitCost: 10
palletTi: 1
palletHi: 1
each:
eachDepth: 2
eachWeight: 2
eachWidth: 2
eachHeight: 2
eachGTIN: 06248911077085
supplierStockID: '123456'
orderableGTIN: 06248911077085
- Orderable:
batteryTechnologyType: Does Not Contain a Battery
productId: 00889817835087
electronicsIndicator: 'No'
rppc: 'No'
shipsInOriginalPackaging: 'No'
endDate: '2059-12-31T00:00:00.000Z'
price: 22.98
isPrivateLabelOrUnbranded: 'Yes'
chemicalAerosolPesticide: 'No'
MustShipAlone: 'Yes'
startDate: '2024-01-01T00:00:00.000Z'
Visible:
Athletic Shoes:
california_state_chemical_warning_text: None
shoeSize: '6'
color: Multi
gender: Female
heel_height_style: Flat Heel
condition: New
keyFeatures:
- 'Shoe Closure: Adjustable Lace-Up Closure'
- 'Materials: Polyurethane & Polyester Upper with Leather & TPR Outsole'
- 'End Use: Perfect for everyday wear!'
- 'Features: Odor Control and Memory foam insole for added comfort'
- 'Clean and Care: Wipe clean with a damp cloth and allow to air dry'
- 'Country of Origin: China'
productName: Avia Women's Air Sneaker 2
manufacturer: Import - ACI International
countPerPack: 1
multipackQuantity: 1
isProp65WarningRequired: 'No'
variantAttributeNames:
- shoeSize
- color
fabricCareInstructions:
- Wipe Clean
shoeSoleMaterial:
- TPR
- Leather Flocking
insole_material: Memory Foam
athletic_shoe_type: Walking Shoes
netContent:
productNetContentMeasure: 1
productNetContentUnit: Each
brand: Avia
colorCategory:
- Blue
shoeCategory:
- Women's Shoes
shoeClosure:
- Lace-Up
has_written_warranty: 'No'
assembledProductHeight:
unit: in
measure: 4.9
count: 1
footwearHeelStyle:
- Chunky
shortDescription: W AV SNEAKER
ageGroup:
- Adult
clothing_occasion:
- Everyday
assembledProductWeight:
unit: lb
measure: 1.5
assembledProductWidth:
unit: in
measure: 8.5
manufacturerPartNumber: WMAV24AC001E
assembledProductLength:
unit: in
measure: 11.2
material:
- Polyurethane
- Polyester
variantGroupId: 00889817835087
isPrimaryVariant: 'Yes'
toeStyle: Closed Toe
modelNumber: AVA23F0138B-6
shoeWidth: Medium
smallPartsWarnings:
- 0 - No warning applicable
insole_color: Black
sport:
- Walking
shoeSizeSystem:
- US Women's
TradeItemApparel:
supplierId: '13337250'
replenishmentItemType: 43 - Import
productId: 00889817835087
seasonCode: 0 - Basic
factoryId:
- '36198157'
palletHi: 4
informationProviderGLN: '13337'
each:
eachDepth: 11.2
eachWeight: 1.5
eachWidth: 8.5
eachHeight: 4.9
eachGTIN: 00889817835087
batchNumberIndicator: 'Yes'
countryOfOriginAssembly:
- CN - China
isBreakPack: 'Yes'
unitCost: 10.5107
palletTi: 2
case:
qtySellableItemsCase: 12
caseHeight: 11.811
caseGTIN: '50889817835082'
caseWidth: 21.063
caseDepth: 26.5748
caseWeight: 20.1503
supplierStockID: WMAV24AC001E
seasonYear: 2024
orderableGTIN: '50889817835082'
OMNI_DSV_ITEM:
value:
SupplierItemFeedHeader:
businessUnit: WALMART_US
locale: en
version: 5.0.20230801-10_11_15-api
SupplierItem:
- Visible:
Movies:
title: Dragon Ball Super- Super Hero
condition: New
has_written_warranty: 'No'
studioProductionCompany:
- 'Funimation '
shortDescription: The Red Ribbon Army is back. Gohan and Piccolo will have to tap into powerful new abilities to defeat these fearsome enemies!
california_state_chemical_warning_text: None
movie_and_tv_media_format:
- 4K Ultra HD
director:
- Tetsuro Kodama
actors:
- Masako Nozawa
- Aya Hisakawa
- Ryô Horikawa
- Takeshi Kusao
isDubbed: 'No'
hasSubtitles: 'No'
duration:
unit: min
measure: 99
mainImageUrl: https://www.accessingram.com:443/content_images/movies/xxl/ING_DWMNCIS4.jpeg
narrated: 'No'
resolution: 4K UHD
countPerPack: 1
sportsLeague:
- N/A
sportsTeam:
- N/A
multipackQuantity: 1
productName: Dragon Ball Super- Super Hero (Steelbook) (Walmart Exclusive) (4K Ultra HD + Blu-Ray), Starring Masako Nozawa
count: 1
mpaaRating: PG-13
movieGenre: Anime
manufacturer: 'Funimation '
prop65WarningText: None
isProp65WarningRequired: 'No'
productSecondaryImageURL:
- https://www.accessingram.com:443/content_images/movies/xxl/ING_DWMNCIS4.jpeg
- https://www.accessingram.com:443/content_images/movies/xxl/ING_DWMNCIS4.jpeg
assembledProductHeight:
unit: in
measure: 1
assembledProductWeight:
unit: oz
measure: 0.52
assembledProductWidth:
unit: in
measure: 5.5
keyFeatures:
- <b>Dragon Ball Super- Super Hero (Steelbook) (Walmart Exclusive) (4K Ultra HD + Blu-Ray)</b>
- ' Japanimation'
- PG-13
- 'Funimation '
netContent:
productNetContentMeasure: 0.52
productNetContentUnit: Ounce
Orderable:
sku: ACDF 10939
supplierId: '123456789'
countryOfOriginAssembly:
- US - United States
factoryId:
- None
price: 30.56
chemicalAerosolPesticide: 'No'
batteryTechnologyType: Does Not Contain a Battery
electronicsIndicator: 'No'
isPrivateLabelOrUnbranded: 'No'
productIdentifiers:
productIdType: UPC
productId: '704400109393'
shippingDimensions:
ShippingDimensionsWidth: 5.5
ShippingWeight: 0.52
ShippingDimensionsDepth: 7.5
ShippingDimensionsHeight: 1
unitCost: 25.9
StreetDateType: SHIP_BY
endDate: '2049-12-01T00:00:00.000Z'
IsPreorder: 'Yes'
MustShipAlone: 'No'
stateRestrictions:
- stateRestrictionsText: None
shipsInOriginalPackaging: 'Yes'
MinimumAdvertisedPrice: 0
StreetDate: '2023-11-21T00:00:00.000Z'
startDate: '2023-08-28T00:00:00.000Z'
- Visible:
Movies:
title: 'Dark Winds: The Complete Second Season'
condition: New
studioProductionCompany:
- RLJ
shortDescription: 'In Season 2, Lt. Joe Leaphorn reunites with Jim Chee, his former deputy turned private eye when their separate cases bring them together in pursuit of the same suspect. They find themselves in the high desert of Navajo Country chasing a killer.
'
california_state_chemical_warning_text: None
has_written_warranty: 'No'
movie_and_tv_media_format:
- Blu-ray
director:
- Graham Roland
actors:
- Zahn McClarnon
- Kiowa Gordon
- "Jessica Matten\n. \nRainn Wilson\n"
- Noah Emmerich
isDubbed: 'No'
hasSubtitles: 'No'
duration:
unit: min
measure: 270
mainImageUrl: https://www.accessingram.com:443/content_images/movies/xxl/ING_DWMNCIS4.jpeg
narrated: 'No'
resolution: 1080p
countPerPack: 1
sportsLeague:
- N/A
sportsTeam:
- N/A
multipackQuantity: 1
productName: 'Dark Winds: The Complete Second Season (Blu-Ray), Starring Zahn McClarnon'
count: 1
mpaaRating: Not Rated
movieGenre: Thriller
manufacturer: RLJ
prop65WarningText: None
isProp65WarningRequired: 'No'
productSecondaryImageURL:
- https://www.accessingram.com:443/content_images/movies/xxl/ING_DWMNCIS4.jpeg
- https://www.accessingram.com:443/content_images/movies/xxl/ING_DWMNCIS5.jpeg
- https://www.accessingram.com:443/content_images/movies/xxl/ING_DWMNCIS3.jpeg
- https://www.accessingram.com:443/content_images/movies/xxl/ING_DWMNCIS2.jpeg
- https://www.accessingram.com:443/content_images/movies/xxl/ING_DWMNCIS1.jpeg
assembledProductHeight:
unit: in
measure: 1
assembledProductWeight:
unit: oz
measure: 0.52
assembledProductWidth:
unit: in
measure: 5.5
keyFeatures:
- '<b>Dark Winds: The Complete Second Season (Blu-Ray)</b>'
- Thriller
- Not Rated
- RLJ
netContent:
productNetContentMeasure: 0.52
productNetContentUnit: Ounce
Orderable:
sku: RLJ BRAMC00356
supplierId: '232323231'
countryOfOriginAssembly:
- US - United States
factoryId:
- None
price: 19.67
chemicalAerosolPesticide: 'No'
batteryTechnologyType: Does Not Contain a Battery
electronicsIndicator: 'No'
isPrivateLabelOrUnbranded: 'No'
productIdentifiers:
productIdType: UPC
productId: 014381003567
shippingDimensions:
ShippingDimensionsWidth: 5.5
ShippingWeight: 0.52
ShippingDimensionsDepth: 7.5
ShippingDimensionsHeight: 1
unitCost: 16.67
StreetDateType: SHIP_BY
endDate: '2049-12-01T00:00:00.000Z'
IsPreorder: 'Yes'
MustShipAlone: 'No'
stateRestrictions:
- stateRestrictionsText: None
shipsInOriginalPackaging: 'Yes'
MinimumAdvertisedPrice: 0
StreetDate: '2023-10-24T00:00:00.000Z'
startDate: '2023-09-01T00:00:00.000Z'
OMNI_MAINTAINANCE (Product Content):
value:
SupplierItemFeedHeader:
businessUnit: WALMART_US
version: 5.0.20230729-20_18_46-api
locale: en
SupplierItem:
- Visible:
Tie-Down Ratcheting:
color: Yellow, Black
dimensions: 2" x 27'
colorCategory:
- Yellow
- Black
assembledProductLength:
measure: 27
unit: ft
breakingStrength:
measure: 10000
unit: lb
workingLoadLimit:
measure: 3333
unit: lb
Orderable:
productId: 00859795002238
- Visible:
Beef:
mainImageUrl: https://i5-qa.walmartimages.com/asr/52ffb807-1b59-43a2-af95-8e189b0e2055.2aa8adda313db82007a039707b0bf9c6.png
productSecondaryImageURL:
- https://i5-qa.walmartimages.com/asr/8082466b-8086-4d37-8989-230284a06d2e.f06b26f5fb48a538d065822a0f1b98f3.jpeg
- https://i5-qa.walmartimages.com/asr/7c85c542-e9c1-4012-844f-8db2c5ef4084.f7881c80e465fb23bcb55d9f01dc0883.jpeg
- https://i5-qa.walmartimages.com/asr/8082466b-8086-4d37-8989-230284a06d2e.f06b26f5fb48a538d065822a0f1b98f3.jpeg
- https://i5-qa.walmartimages.com/asr/7c85c542-e9c1-4012-844f-8db2c5ef4084.f7881c80e465fb23bcb55d9f01dc0883.jpeg
- https://i5-qa.walmartimages.com/asr/8082466b-8086-4d37-8989-230284a06d2e.f06b26f5fb48a538d065822a0f1b98f3.jpeg
- https://i5-qa.walmartimages.com/asr/7c85c542-e9c1-4012-844f-8db2c5ef4084.f7881c80e465fb23bcb55d9f01dc0883.jpeg
Orderable:
productId: 06212412546791
- Orderable:
productId: 06212412546791
hasFuelContainer: 'No'
sustainabilityFeatureCode:
- Biodegradable
batteryTechnologyType: Mercury
OMNI_MAINTAINANCE (Supply Chain):
value:
SupplierItemFeedHeader:
version: 5.0.20230729-20_18_46-api
locale: en
businessUnit: WALMART_US
SupplierItem:
- SupplyChain:
DSVSupplyChain:
walmartItemNumber: '650902187'
productId: 06893751444520
seasonCode: 2 - Summer
seasonYear: 2016
factoryId:
- '12345'
batchNumberIndicator: 'Yes'
countryOfOriginAssembly:
- US - United States
- SupplyChain:
OnlineSupplyChain:
walmartItemNumber: '650902187'
productId: 06893751444520
countryOfOriginAssembly:
- US - United States
multipart/form-data:
schema:
required:
- file
type: object
properties:
file:
type: string
description: 'Specifies the feed file to upload.
For a detailed feed file structure overview, reference the <a href="https://developer.walmart.com/doc/us/us-supplier/us-supplier-items/" target="_blank">Items Guide</a>.
'
format: binary
examples:
OMNI_ONLINE_ITEM:
value:
SupplierItemFeedHeader:
businessUnit: WALMART_US
locale: en
version: 5.0.20230731-22_03_36-api
SupplierItem:
- Orderable:
batteryTechnologyType: Does Not Contain a Battery
productId: 06248911077085
electronicsIndicator: 'No'
rppc: 'No'
price: 2
isPrivateLabelOrUnbranded: 'No'
chemicalAerosolPesticide: 'No'
shipsInOriginalPackaging: 'No'
Visible:
Candy Corn:
occasion:
- Birthday
california_state_chemical_warning_text: None
container_material:
- Beta
keyFeatures:
- Test123
- Test123
- Test123
condition: New
productName: Butter Finge Candy 11ozChoc123
food_condition:
- Frozen
manufacturer: CandyMan
pieceCount: 2
countPerPack: 10
multipackQuantity: 10
isProp65WarningRequired: 'No'
netContent:
productNetContentMeasure: 10
productNetContentUnit: Fluid Ounces
foodForm:
- Balls
ib_retail_packaging: Bundle
brand: Butter Finger
mainImageUrl: https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
servingSize: small
servingsPerContainer: '2'
productSecondaryImageURL:
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
- https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
containerType:
- Bag
texture:
- liquid
count: 10
sizeDescriptor: Full Size
shortDescription: http://walmart.com
flavor: caramel
size: Size
ingredientListImage: https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
nutritionFactsLabel: https://i5-qa.walmartimages.com/asr/88fb5c36-80ef-420d-a175-7b280703f32b.671d1ee9da9e2448d1023a36eb859dfb.jpeg
TradeItem:
countryOfOriginAssembly:
- US - United States
productId: 06248911077085
isBreakPack: 'No'
supplierId: '123456789'
factoryId:
- None
unitCost: 10
palletTi: 1
palletHi: 1
each:
eachDepth: 2
eachWeight: 2
eachWidth: 2
eachHeight: 2
eachGTIN: 06248911077085
supplierStockID: '123456'
orderableGTIN: 06248911077085
- Orderable:
batteryTechnologyType: Does Not Contain a Battery
productId: 00889817835087
electronicsIndicator: 'No'
rppc: 'No'
shipsInOriginalPackaging: 'No'
endDat
# --- truncated at 32 KB (2324 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/walmart/refs/heads/main/openapi/walmart-items-api-openapi.yml