Walmart Dropship Vendor Items API
The Walmart Order Management API help 1P suppliers stay up to date on order fulfillment.
OpenAPI Specification
openapi: 3.0.1
info:
title: Walmart Item Management
description: "The Item Management API requests set up and manage items on Walmart.com. \n\nUsers can begin the integration process after completing registration and obtaining access to their consumer ID and private key.\n\n**April 2024**<br>Built: 04/29/2024, 17:21:04\n"
version: '1.0'
servers:
- url: https://api-gateway.walmart.com
description: Production URL
- url: https://sandbox.walmartapis.com
description: Sandbox URL
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.\r\n\r\n"
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\r\n. \r\nRainn Wilson\r\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.
# --- truncated at 32 KB (2463 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/walmart/refs/heads/main/openapi/walmart-dropship-vendor-items-openapi-original.yml