Jump to Content
US Marketplace
HomeGuidesAPI ReferenceChangelogWhat's NewDeprecation GuideHelp
My AccountUS Marketplace
Guides
My Account
HomeGuidesAPI ReferenceChangelogWhat's NewDeprecation GuideHelp

Getting started

  • Introduction to Walmart Marketplace APIs
  • Get an access token using Token API
  • Retrieve access token details
  • Get started as a seller
  • Get started as an approved Solution Provider
    • Register and publish on the Walmart App Store
    • Marketplace API support with Solution Provider Center
    • Simulate App Connect in sandbox
  • Integrate with Walmart Marketplace APIs
  • OAuth 2.0 authorization
  • API scopes for Walmart Marketplace
  • Delegated access authorization

Advertising

  • Search Engine Marketing
    • SEM APIs
    • Campaign management
      • Create a new campaign
      • Update an existing campaign
      • Stop a running campaign
      • Delete an existing campaign
      • Get details of a campaign
    • Catalog management
      • Get top recommended items
      • Check eligibility of items
    • Reporting
      • Get Campaign-level performance report
      • Get item-level performance report
      • Get billing history
      • SEM performance report
    • API status codes and errors

Assortment Recommendations

  • Assortment recommendations overview
  • Get recommendations API
  • Get variants API
  • Get recommendation trends API
  • Get categorization API
  • Reject recommendations API
  • (Legacy) Bulk download recommendations APIs

Changelog

  • Walmart Marketplace API deprecation guide

Claims

  • Shipment protection API overview
    • Choose a shipment protection API
    • Submit a claim
    • List all claims
    • Get details of a claim
    • Get claim history
    • Submit additional information
    • Download claim documents

Disputes

  • Disputes
  • Resolving duplicate items
  • Contest duplicate dispute
  • Checking dispute status

Feeds

  • Feeds overview
  • List all feed statuses
  • Feed item status API for tracking fitment files
  • Fitment error report download

Insights

  • Insights API overview
  • Retrieve Pro Seller tier status and reward details
  • Get unpublished item insights
  • Retrieve Listing Quality score
  • Find categories with listing quality issues
  • Filter for item listing quality metrics
  • Seller Performance API overview
    • Retrieve negative feedback performance summary
    • Retrieve negative feedback report
    • Retrieve returns performance summary
    • Retrieve returns performance report
    • Retrieve item not received performance summary
    • Retrieve item not received report
    • Retrieve valid tracking rate summary
    • Retrieve valid tracking rate reports
    • Retrieve ship-from location accuracy summary
    • Retrieve ship-from location accuracy report
    • Retrieve late shipment summary
    • Retrieve late shipment reports
    • Retrieve on-time shipment summary
    • Retrieve on-time shipment reports
    • Retrieve carrier method accuracy summary
    • Retrieve carrier method accuracy reports
    • Retrieve seller response rate summary
    • Seller response rate reports
    • Retrieve order refunds summary (Deprecated)
    • Order refunds reports
    • Retrieve on-time delivery summary
    • On-time delivery reports
    • Retrieve order cancellations summary
    • Order cancellations reports

Inventory

  • Inventory API overview
    • Calculate your inventory
    • Download inventory schemas
  • Choose an Inventory API
  • Retrieve inventory data
    • Get item inventories for all ship nodes
      • Return 10 items
      • Return up to 50 items
      • Return more than 50 items
    • Get inventory count for an item
    • Get single item inventory by ship node
  • Update inventory data
    • Update inventory in bulk
    • Update single inventory
    • Update single item inventory by ship node
  • Create inventory event notifications

ITEMS

  • Item Management API overview
    • Item management API requests
    • Item spec: versioning and diff reporting
    • Item management SLA and terminology
    • Item management API rate limits
  • Understanding the requirements for listing an item
    • Get item setup requirements
  • Create items on Walmart.com
    • Item search for the Walmart catalog
    • Create an offer for an existing Walmart item
    • Create a new seller-fulfilled item (Full item setup)
      • POST item setup by product type: Feed file structure overview
      • Item setup schema key points
    • Setting up multiple variants of an item
    • Collectibles item setup
    • Repricing during item setup
  • Get my item details and insights
    • Catalog search for the seller catalog
      • Limit and pagination
    • View my GTIN exemption status
    • Get item count by status
    • Get item associations
    • Get item count by groups
    • Monitor item listing quality
  • Post item creation management recommendations

Lag Time

  • Lag time API overview
    • Get lag time for an item
    • Update lag time for an item

Notifications

  • Notifications overview
  • Notifications workflow
  • Test Notification API
  • All subscriptions
  • Create subscription
  • Update subscription
  • Delete subscription
  • Get event types
  • Subscribe to an event notification
    • Buy Box 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
    • Driver status notification
    • Order management event
    • Assortment recommendations notification
  • Performance webhooks
    • Set up your Performance webhook endpoint
    • Subscribe to the performance webhook
    • Security and authenticity
    • Test in sandbox
    • Troubleshooting and delivery health
    • Event catalog
      • Performance warning
      • Seller performance alarms
      • Seller performance report

On-request Reports

  • On-request reports API overview
  • Request and download a report
  • Use report filters
  • Report status notifications
  • Choose a reports API
  • Report types
    • Advertising
      • Request an SEM performance report
    • Catalog and growth
      • Request an item report
      • Request an assortment recommendations report
      • Request ACES coverage and fitment attributes gap reports
    • Inventory and fulfillment readiness
      • Request a lag time report
      • Request a shipping configuration report
      • Request a shipping program report
      • Request an inventory report
    • Orders and post-purchase quality
      • Request a cancellation report
      • Request a delivery defect report
      • Request a return item overrides report
    • Pricing and performance
      • Request a Buy Box insights report
      • Request a CPA report
      • Request a promotions report
      • Request an item performance report
    • Recommendations
      • Request an inventory recommendations report
    • Walmart Fulfillment Services (WFS) Reports
      • Request an inventory reconciliation report
      • Request a settlement report
      • Request an order report
      • Request a customer returns report
  • Reports scheduler API overview
    • Create a report schedule
    • Get all report schedules
    • Get single report schedule
    • Update a report schedule
    • Delete a report schedule

Orders Management

  • Orders Management API overview
  • Download orders schemas
  • Choose an Orders API
  • Retrieve orders
    • All orders
    • All released orders
    • An order
  • Acknowledge orders
    • Acknowledge an order
  • Shipping, cancellations, and refunds
    • Ship an order
      • Supported carrier names
    • Cancel orders
    • Refund orders
  • Multi-Line Multi-Quantity (MLMQ) migration guide

payments

  • Payments
    • Entity Match API
  • Tax forms API overview
    • Get tax forms
    • Download tax form PDF

Payment Reports

  • Marketplace payment reports overview
    • Recon report (Legacy)
    • Recon Report JSON
    • Recon Report
    • Available recon report dates (Legacy)
    • Available recon report dates
    • Payment Statement Report
    • Performance Report

Pricing

  • Pricing and promotions management API (New)
  • Repricer strategy
    • Create a new repricer strategy
    • Retrieve repricer strategy details
    • Update an existing repricer strategy
    • Delete a repricer strategy
    • Assign/unassign items to/from repricer strategy
      • Assign items to a repricer strategy
      • Unassign items from a repricer strategy
      • Pause items from a repricer strategy
  • Update pricing
    • Update pricing for a single item
    • Update pricing for multiple items in bulk (New)
  • Price incentives overview
    • All Items: Manage Walmart-funded incentives enrollment
    • Specific items: Manage Walmart-funded incentives enrollment
    • Manage enrollment in Reduced Referral Fee incentives
    • Retrieve price incentives data
  • Get pricing insights
  • Promotional pricing error codes
  • Price management API (Deprecated)

Promotions

  • Pricing and promotional pricing management API overview
  • Update promotional pricing for a single item
  • Update promotional pricing for multiple items (New)
  • Promotion price error codes

Rate limiting

  • Rate limiting

Recommendations

  • Get WFS recommended shipment quantity
  • Get WFS restock recommendations
  • Fulfill with WFS recommendations
  • Get WFS unpublished recommendations

Returns

  • Returns API overview
    • Download schemas for Returns API
    • Choose a Returns API
      • Retrieve return order details
      • Issue a refund
      • Process return overrides

Reviews

  • Reviews API overview
    • Bulk update item status
    • Get RAP post-purchase items
      • Get eligible items
      • Get enrolled items
      • Get complete items
      • Filter, search, and sort items
    • Get categories

Sandbox

  • Walmart sandbox
    • Dynamic sandbox
    • Get sandbox credentials
    • Test Marketplace APIs
    • Feeds validations
    • Sandbox throttling limits

Settings Management

  • Settings Management overview
    • Get shipping template details
    • Update shipping templates
    • Delete shipping templates
    • Get all fulfillment centers
    • Update fulfillment centers
    • Create fulfillment center
    • Get account level settings
    • Update account level settings
    • Create account level settings
    • Get all shipping templates
    • Create shipping templates
    • Third-party fulfillment center association
    • Get shipping configurations
    • Get shipping template activation status
    • Get coverage for fulfillment centers
    • Get carrier methods
    • Get all third-party fulfillment providers
    • Get partner configurations

Ship with Walmart

  • Ship with Walmart

Simplified Shipping Settings (New)

  • Simplified Shipping Settings API overview
    • Update FC level Simplified Shipping Settings
    • Update Simplified Shipping Settings
    • Create Simplified Shipping Settings
    • Bulk item migration for Simplified Shipping Settings
    • Get Simplified Shipping Settings

utiliites

  • Utility APIs
    • Get item taxonomy by spec
    • Get all departments
    • Get all categories
    • Get API platform status

Walmart Fulfillment Services (WFS)

  • Walmart Fulfillment Services (WFS) overview
  • Set up items for WFS
    • Restrict item sale by state or zip code
  • Convert items for WFS
  • Create an inbound shipment order
  • WFS hazmat items on hold
  • Fetch inbound preview
  • Retrieve inbound shipment details
  • WFS on-request reports
  • Retrieve inbound shipment items details
  • Check for inbound order errors
  • Update shipment quantities
  • Submit shipment tracking details
  • Cancel an inbound order
  • WFS Get Inventory (New)
  • Get inventory reconciliation data for WFS item
  • Download WFS inventory health report
  • Retrieve inventory log for a WFS item
  • Get WFS inventory (Legacy)
  • Multichannel Solutions
    • Create customer order for WFS item
    • Fetch delivery promise details
    • Cancel customer order for WFS item
    • Get fulfillment order status
    • Create return for customer order for WFS item
    • Get return order status
    • Cancel return order
    • Create MCS sales channel details (New)
    • Get MCS sales channel details (New)
    • Update MCS sales channel details (New)
    • WFS Multichannel Solutions (MCS) API Sandbox Guide
      • Getting Started
      • Multichannel solutions APIs in sandbox
      • MCS sales channel management APIs
      • MCS items management APIs
      • MCS order management APIs
      • MCS return order APIs
      • MCS order tracking APIs
      • Errors and behaviors
      • MCS sandbox FAQs
  • Walmart Preferred Carriers
    • Create carrier rate quote (New)
    • Get carrier rate quote (New)
    • Create Booking (New)
    • Get booking (New)
    • Cancel booking (New)
    • Generate label (New)
    • Download label (New)
    • Print Bill of Lading (BOL) (New)
    • Get shipment tracking details (New)
    • Get pickup seller schedule (New)
    • Update pickup scheduling (New)
  • Create an inbound purchase order (Legacy)
  • Check status of an inbound purchase order (Legacy)

Walmart+ Seller-Fulfilled

  • Walmart+ Seller-Fulfilled Fulfillment (SFF)
    • Bulk Item Enrollment for Walmart+

Troubleshooting

  • Marketplace troubleshooting resources
    • Authentication
    • Error codes
    • General API problems
    • Item & inventory
    • Orders
    • Pricing
    • Reports
    • Shipping & fulfillment

FAQ

  • Analytics dashboard
  • API integration & usage
  • Authentication & authorization
    • OAuth authentication
  • Getting started
  • Item & inventory
  • Orders & returns
  • Pricing & promotions
  • Reports
  • Sandbox
  • Shipping & fulfillment

Glossary

  • Glossary

Getting started guide for sellers (OLD)

The Walmart Marketplace APIs provide resources for sellers to manage their items, orders, prices, promotions, inventory, reports, and more on Walmart.com. The first step is to register as a seller on Walmart Marketplace.

Register as a seller on Walmart Marketplace

  1. Learn about the process for becoming a Marketplace seller.
  2. Follow our guide in Marketplace Learn to complete your Seller Center Onboarding process.
    • Register as a seller on Walmart Marketplace
Developer Portal
Terms and Conditions Privacy Policy
© 2026 Walmart. All rights reserved.