Walmart Developer Portal

Marketplace seller and supplier developers can get access to API tools and documentation to integrate with the Walmart eCommerce platform.


Marketplace Partner sellers can manage items, orders, prices, inventory, and more with Marketplace APIs.

Get started

Learn more


Drop ship partners can scale their business to present items to millions of customers. To set up your business with Walmart, use the tools and APIs to provide access to manage the items.

Get started

Learn more

Warehouse Suppliers can set up their business with Walmart APIs to scale their business to make their items available to millions of customers.

Get started

Learn more


Content service providers help suppliers to set up their catalog with Walmart to create enriched content, provide API integration, and act as a bridge between suppliers and Walmart.

Get started

Learn more


Advertising Partners can carry out ads campaign management, optimization and retrieve on-demand performance metrics for Advertisers (Sellers, and Suppliers) with Walmart Connect’s Ads APIs.

Get started

Learn more


Welcome to the Walmart Developer Portal! Marketplace sellers and suppliers can find all the tools they need to begin the API integration process and access the API documentation. The API documentation provides seller and supplier developers and partners with the tools to become Drop Ship Vendors (DSVs), Marketplace Sellers, or Content Service Providers along with the developer solutions to succeed with their customers. Get started now and begin the API integration process and access the API documentation. Also, learn about product XSDs and use the API Explorer page to test your APIs.

We provide a comprehensive suite of tools to support our Partners:
  • API Status checker – Verify status of all APIs.
  • Try it Out – Try out API calls in the browser and view responses.
  • API Sandbox – Test your APIs on the backend.
  • API Documentation – How-to guides, API Reference, and FAQ.
To stay up to date with the latest offerings of the Walmart API Developer Portal, be sure to check out our What’s New page!
Access our comprehensive documentation to learn about our RESTful APIs. The API reference provides details about the endpoints, request/response structures, and sample codes. You can also find information about throttling limits, error codes, and other useful information. In addition, you can download the latest version of the XSDs.

How to get started

How do I get started?

Register to get your API Key

    1. For Marketplace:
      1. Sign Up
        1. Seller: Log in to the Developer Portal to get your Client ID and Client Secret.
        2. Solution Provider: Apply here and work with your seller to get your delegated access keys.
      2. After registration, you will receive your portal login credentials.
      3. Log in to the Developer Portal to get your API keys.
        1. From the top right, select My Account
        2. Select the Login Type applicable to you.
    2. For Walmart 1P:
      1. Supplier or Drop Ship VendorApply here to join
        1. Log in to the Developer Portal to get your API keys.
        2. From the top right, select My Account
        3. Select the Login Type applicable to you.
      2. Content Service Providers: Send an email to
    3. You will receive your portal login credentials after registration.
    4. Log in to the Developer Portal to get your API keys.
How do I integrate my application with the platform?
Integrate Your Application with Item Management APIs

Use the API Explorer page to test the APIs. Integrate your application with the item management platform by calling the item management APIs.
For setting up an item, use the provided XSDs to build an XML payload to ingest item feeds.

How can I test out my APIs? Do you have a test environment?

For Marketplace:

Yes! Use Walmart API Sandbox

The Walmart API Sandbox provides an environment to test Walmart APIs to ensure a successful integration and production launch. The Sandbox is only for backend testing of APIs and there is not an option to view or test on This environment uses test-only elements and simulated responses (based on mock data) and calls to applications in real-time.

All URLs, Endpoints, Users, Items, Orders, and currency/funds within the Sandbox are for testing purposes only. This environment provides production simulation, debugging, reports, and the ability to monitor API behavior before moving to production.

For Walmart 1P:

We currently do not have a Sandbox for testing. All testing will be done on production and so work closely with your integration contact.

See what's new

Item Spec v 4.5

There is a new Item Spec v 4.5 available for you to use. What changes we are making? – Adding Sales Restrictions in 2 categories, ‘Furniture’ and ‘Large Appliances’: If a seller is setting up items in categories ‘Furniture’ and ‘Large Appliances’, they are required to complete Restriction Type. – Additional Details: If the seller […]

PreGenerated Reports will be retired starting June 30th, 2022

If you are still using the day old, PreGenerated Reports please migrate now to OnRequest reports that give near-real time data. Report Type Retirement Date Item Report June 30th, 2022 Other PreGen Reports July 29th, 2022

Items Variants API Update

You can now see the variant grouping information on the APIs as well.  A new API “Get item count by groups” can be used to get information on the variant group id and the count of variants items in the group. The existing APIs (Catalog Search, Get an item, Get all items) can return variant […]

Refund Order Lines API Update

The Refund Order lines API has been enhanced to calculate the tax and convert full price adjustment to returns. Include the isFullRefund as true or enter the full price for full price adjustments Please upload the full Adjustments and partial adjustments separately to avoid getting errors. For more information, see Issue Refund API in the reference.

New Marketplace Item spec v4.4

The new Marketplace Item spec v4.4 now supports the ability to submit Multiple Category Specs dynamically in Seller Center. For more information and to download the Item spec versions, see Item spec v4 in the Guide.

Hazmat Item Feedback Loop API

Use this API to see a list of items that are on hold for hazmat compliance review, including items with an In Review, Action Needed, and Prohibited status. Also use this API to review your Action Needed error descriptions and understand how to correct them for further assessment.Your items will not be eligible for WFS until the hazmat […]