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 Walmart Marketplace APIs
Get started as a seller
Get started as a Solution Provider
Integrate with Walmart Marketplace APIs

Authorization

Delegated access authorization

Authorization - OAuth 2.0

OAuth 2.0 authorization

Assortment Recommendations

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

Disputes

Disputes
- Checking dispute status
- Resolving duplicate items

Feeds

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

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

Inventory

Inventory API overview
- Calculate your inventory
- Download inventory schemas
Choose an Inventory API
Retrieve inventory data
Update inventory data
Create inventory event notifications

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
- Automotive fitment
Item management API rate limits
Post item creation management recommendations

Lag Time

Lag time API overview

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

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

Orders

Orders API overview
Download orders schemas
Choose an Orders API
Retrieve orders
Acknowledge orders
- Acknowledge an order
Shipping, cancellations, and refunds

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

Pricing

Pricing and promotional pricing management (New)
Repricer strategy
Update pricing
- Update pricing for a single item
- Update pricing for multiple items (bulk)
Price incentives overview
Promotional pricing error codes
Adjust seller offers with CAP
Price management API (Deprecated)

Promotions

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

Returns

Returns API overview
- Download schemas for Returns API
- Choose an Returns API

Reviews

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

Sandbox

Walmart sandbox

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

Shipping

Buy shipping

Simplified Shipping Settings (New)

Simplified Shipping Settings API overview

Throttling

Throttling

Utilities

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

Walmart Fulfillment Services (WFS)

Walmart Fulfillment Services (WFS) API overview
Set up items for WFS
Get return order status
Restrict item sale by state or zip code
Convert items for WFS
Create customer order for WFS item
Get WFS inventory
Fetch delivery promise details
Cancel customer order for WFS item
Get fulfillment order status
Create return for customer order for WFS item
Cancel return order
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)
WFS hazmat items on hold
Get WFS inventory health report
Get inventory log for a WFS item
Inbound preview
(Legacy) Create an inbound purchase order
(Legacy) Check status of an inbound purchase order (IO)

Errors

Error codes

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 5 months ago

Resources

API Health Dashboard

Marketplace Learn

Helpful Links

Terms and Conditions

© 2025 Walmart. All rights reserved. Privacy Notice