Jump to Content
Marketplace Partners
HomeGuidesAPI ReferenceChangelogAPI StatusHelp
v1.0

My AccountMarketplace Partners
Guides
My Account
v1.0HomeGuidesAPI ReferenceChangelogAPI StatusHelp

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 a Solution Provider
  • Integrate with Walmart Marketplace APIs
  • Authorization
    • Delegated access authorization
  • OAuth 2.0 authorization
    • Find and connect a solution provider
    • Log in and authorize app scope
    • Transfer authorization and refresh token
    • API scopes for Walmart Marketplace

Advertising

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

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 Pro Seller tier status and reward details
  • Seller Performance API overview
    • Valid tracking rate summaries
    • Valid tracking rate reports
    • Ship-from location accuracy summaries
    • Ship-from location accuracy reports
    • On-time shipment summaries
    • On-time shipment reports
    • Carrier method accuracy summaries
    • Carrier method accuracy reports
    • Seller response rate summaries
    • Seller response rate reports
    • Order refunds summaries
    • Order refunds reports
    • On-time delivery summaries
    • On-time delivery reports
    • Order cancellations summaries
    • 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
  • Understanding the requirements for listing an item
    • Get item setup requirements
  • Create items on Walmart.com
    • Walmart catalog item search
      • Limit and pagination
    • Create an offer for an existing Walmart item
    • Create a new item (Full item setup)
      • POST item setup by product type: Feed file structure overview
      • Item setup schema key points
    • Collectibles item setup
    • Repricing during item setup
  • Monitor my item submission
  • Get my item details and insights
    • Get item count by status
    • Get item associations
    • Get item count by groups
    • Setting up multiple variants of an item
    • Get insights on my existing items
  • 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
  • Reports Scheduler
  • Request an API traffic report

Orders

  • Orders API overview
  • Download orders schemas
  • Choose an Orders API
  • Retrieve orders
    • Get all orders
    • Get all released orders
    • Get an order
  • Acknowledge orders
    • Acknowledge an order
  • Shipping, cancellations, and refunds
    • Ship an order
      • Supported carrier names
    • Cancel orders
    • Refund orders

payments

  • Payments
  • Entity Match API

Payment Reports

  • Payment Reports
  • 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
    • 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
  • Promotional pricing error codes
  • Adjust seller offers with CAP (Deprecated)
  • Price management API (Deprecated)
  • Get Pricing Insights data for your items

Promotions

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

Rate limiting

  • Rate limiting

Returns

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

Recommendations

  • Get Recommended shipment quantity (New)

Reviews

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

Sandbox

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

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
    • Create Simplified Shipping Settings configurations
    • Update Simplified Shipping Settings configurations
    • Retrieve account configurations
    • Change fulfillment center configurations
    • Simplified Shipping Settings migration

Utilities

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

Walmart Fulfillment Services (WFS)

  • Walmart Fulfillment Services (WFS) overview
  • Set up items for WFS
  • Convert items for WFS
  • Create an inbound shipment order (COPY)
  • Check for inbound order errors
  • Request item details for the IO
  • Request IO shipment details
  • Update shipment quantities prior to delivery
  • Provide shipment tracking details
  • Cancel an inbound order (IO)
  • Restrict item sale by state or zip code
  • Inbound preview
  • WFS hazmat items on hold
  • Get inventory reconciliation data for WFS item
  • WFS Get Inventory (New)
  • Get WFS inventory (Legacy)
  • Get WFS inventory health report
  • Get inventory log for a WFS item
  • 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)
  • Walmart Preferred Carriers
    • Create carrier rate quote (New)
    • Get carrier rate quote (New)
    • Create Booking (New)
    • Cancel booking (New)
    • Generate label (New)
    • Download label (New)
    • Print Bill of Lading (BOL) (New)
  • Create an inbound purchase order (Legacy)
  • Check status of an inbound purchase order (Legacy)

Errors

  • Error codes

FAQ

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

Create items on Walmart.com

These steps are recommended to create items on Walmart.com.

  1. Search for the item: Use the catalog item search API to check if the item you're trying to set up already exists in the Walmart catalog.
  2. Offer setup by match: If your item appears in search listings, use the existing item attributes to list an item.
  3. New item setup: If your item doesn’t appear in search listings, create a new item using the full item setup instructions.

Updated about 2 hours ago


Resources

  • API Health Dashboard
  • API Sandbox
  • Marketplace Learn
  • Helpful Links

  • Seller Center
  • Terms and Conditions
  • © 2025 Walmart. All rights reserved. Privacy Notice