Jump to Content

Home Guides API Reference Changelog API Status Help

v1.0

Guides

v1.0Home Guides API Reference Changelog API Status Help

Introduction

Introduction to Marketplace APIs
Getting started guide for sellers
Getting started guide for solution providers

Authorization

Delegated access authorization

Authorization - OAuth 2.0

OAuth 2.0 authorization

ITEMS

Item Management API overview
Understanding the requirements for listing an item
- Get item setup requirements
Create items on Walmart.com
Monitor my item submission
Get my item details and insights
Update my existing items
- Retire an item
Item management API rate limits
Post item creation management recommendations

Inventory

Inventory API overview
Get single item inventory by ship node (BETA)
Get all item inventories for all ship nodes (BETA)
Update item inventory per ship node (Beta)
Bulk inventory update feeds

Prices

Price and promotional price management API overview (New)
Promotion price error codes
Repricer API overview
Price incentives API overview
Price sequence guarantee
Create strategy repricer API overview
Get strategies repricer API overview
Update strategy repricer API overview
Delete strategy repricer API overview
Assign items to repricer API overview
Price management API overview (Deprecated)

Prices (Rewrite)

Adjust seller offers with CAP

Promotions

Price and promotional price management API overview (New)
Promotion price error codes (New)
Promotional prices API overview (Deprecated)
Promotion price error codes (Deprecated)

Lag Time

Lag time API overview

Feeds

Feeds overview
Feed status API for tracking fitment files
Fitment error report download

Orders

Order management API overview
Get all released orders
Acknowledge a created order
Get order details and status
Ship an order
Cancel one or more order lines

Shipping

Buy shipping

Simplified Shipping Settings

Simplified Shipping Settings

Walmart Fulfillment Services (WFS)

Walmart Fulfillment Services (WFS) API overview
Create customer order for WFS item
Cancel customer order for WFS item
Get fulfillment order status
Fetch delivery promise details
Create return for customer order for WFS item
Get return order status
Cancel return order
Restrict item sale by state or zip code
Set up items for WFS
Convert items for WFS
Check for inbound order errors
Create an inbound shipment order (IO)
Request IO shipment details
Request item details for the IO
Update shipment quantities prior to delivery
Provide shipment tracking details
Cancel an inbound order (IO)
(Legacy) Create an inbound purchase order
(Legacy) Check status of an inbound purchase order (IO)
WFS hazmat items on hold
Get WFS inventory health report
Get inventory log for a WFS item
Inbound preview

Returns

Returns and refunds API overview
Initiate a refund

Disputes

Disputes
- Checking dispute status
- Resolving duplicate items

Payments Report

Payments Report
Parse report CSV file with Java
Generate a payment statement report
Generate a performance report
Generate a reconciliation report
Handle report errors

On-request Reports

On-request reports API Overview
Using filters when requesting reports
Request an item report
Request an inventory report
Request an assortment recommendations report
Request a cancellation report
Request a delivery defect report
Request an item performance report
Request a return item overrides report
Request a promotions report
Request a CPA report
Request a shipping configuration report
Request a shipping program report
Request a lag time report
ACES coverage and fitment attributes gap reports
Request a Buy Box insights report

Insights

Insights API overview
Get unpublished item insights
Get seller's listing quality score
Find categories with Listing Quality issues
Filter for item listing quality metrics
Get seller's badge status and insights
Get seller's Pro Seller tier status and reward details
Throttling information for APIs

Assortment Recommendations

Assortment recommendations overview
Get recommendations API
Get Variants API
GET Trends API
Get categorization API
Bulk Download Recommendations APIs
Reject Recommendations API

Reviews

Reviews API overview
Get RAP post-purchase items
Update status of RAP post-purchase items
Get categories

Notifications

Notifications overview
Notifications workflow
Get event types
Subscribe to an event notification
Buy Box changed event
Inventory OOS event
Offer published event
Offer unpublished event
Purchase order (PO) created event
Purchase order (PO) line auto-canceled event
Report status notification
Return notifications
Order intent to cancel event

Settings

Shipping and fulfillment settings API overview
Shipping overrides (Deliverr 3PL only)
Create/update account level settings
Update a shipping template
Get account level settings
Create a shipping template
Delete a shipping template
Get all shipping templates for a seller
Get the shipping template details
Get partner configurations
Get shipping configurations

Sandbox

Walmart sandbox

Throttling

Throttling

Errors

Error codes

Utilities

Utility API overview
Get item category taxonomy by spec version
API platform status

FAQ

Getting started
Terms and conditions
Marketplace API sandbox
Marketplace 2-day shipping
OAuth authentication
Analytics dashboard

Notifications workflow

The seller journey from subscription APIs and notifications follows this workflow:

Updated 3 months ago

Resources

API Health Dashboard

Marketplace Learn

Helpful Links

Terms and Conditions

© 2025 Walmart. All rights reserved. Privacy Notice