Walmart

Walmart is a multinational retail corporation that operates a chain of hypermarkets, discount department stores, and grocery stores. The company is known for offering a wide range of products at competitive prices, attracting customers from all walks of life. Walmart also provides various convenience services, such as pharmacy, optical, and financial services, making it a one-stop shop for many consumers. The Walmart Marketplace APIs enable third-party sellers to list and sell products, manage orders, inventory, pricing, fulfillment, and reporting on Walmart.com.

Walmart publishes 25 APIs on the APIs.io network, including Assortment Recommendations API, Authorization API, DSV Cost API, and 22 more. Tagged areas include Commerce, Retail, Fortune 100, Marketplace, and E-Commerce.

The Walmart catalog on APIs.io includes 2 event-driven AsyncAPI specifications, 1 JSON-LD context, and 2 Spectral governance rulesets.

Walmart’s developer surface includes authentication, developer portal, documentation, sandbox, support, FAQ, API reference, and 39 more developer resources.

🌐 Visit website 📡 Source on GitHub

60.8/100 strong ▬ flat Agent 41/100 agent ready saas Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessEnterpriseSelf serve

27 APIs 1 MCP Servers 8 Features

Commerce Retail Fortune 100 Marketplace E-Commerce Order Inventory Fulfillment Supply ChainSeller APIsWebhook MCP

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 60.8/100 · strong

Contract Quality 16.1 / 23

Developer Ergonomics 5.0 / 18

Access Clarity 13.3 / 18

Operational Transparency 9.9 / 12

Contract Governance 3.4 / 11

Discoverability 6.7 / 9

Create-or-Update Ergonomics 1.1 / 10

Agent readiness — 41/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/walmart: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 25

Individual APIs this provider publishes, each with its own machine-readable definition.

Walmart Assortment Recommendations API

The Assortment Recommendations API from Walmart — 3 operation(s) for assortment recommendations.

Walmart Authorization API

The Authorization API from Walmart — 2 operation(s) for authorization.

Walmart DSV Cost API

The DSV Cost API from Walmart — 1 operation(s) for dsv cost.

Walmart DSV Orders API

The DSV Orders API from Walmart — 6 operation(s) for dsv orders.

Walmart Feeds API

The Feeds API from Walmart — 3 operation(s) for feeds.

Walmart Fulfillment API

The Fulfillment API from Walmart — 21 operation(s) for fulfillment.

Walmart Insight API

The Insight API from Walmart — 7 operation(s) for insight.

Walmart Inventory API

The Inventory API from Walmart — 6 operation(s) for inventory.

Walmart Items API

The Items API from Walmart — 13 operation(s) for items.

Walmart Lag Time API

The Lag Time API from Walmart — 2 operation(s) for lag time.

Walmart Listing Quality API

The Listing Quality API from Walmart — 3 operation(s) for listing quality.

Walmart Notifications API

The Notifications API from Walmart — 4 operation(s) for notifications.

Walmart On-Request Report API

The On-Request Report API from Walmart — 3 operation(s) for on-request report.

Walmart On Request Reports API

The On Request Reports API from Walmart — 3 operation(s) for on request reports.

Walmart Orders API

The Orders API from Walmart — 7 operation(s) for orders.

Walmart Pre-Generated Reports API

The Pre-Generated Reports API from Walmart — 1 operation(s) for pre-generated reports.

Walmart Prices API

The Prices API from Walmart — 8 operation(s) for prices.

Walmart Promotions API

The Promotions API from Walmart — 3 operation(s) for promotions.

Walmart Reports API

The Reports API from Walmart — 7 operation(s) for reports.

Walmart Returns/Refunds API

The Returns/Refunds API from Walmart — 3 operation(s) for returns/refunds.

Walmart Reviews API

The Reviews API from Walmart — 3 operation(s) for reviews.

Walmart Rules API

The Rules API from Walmart — 14 operation(s) for rules.

Walmart Settings API

The Settings API from Walmart — 11 operation(s) for settings.

Walmart Ship with Walmart API

The Ship with Walmart API from Walmart — 7 operation(s) for ship with walmart.

Walmart Utilities API

The Utilities API from Walmart — 4 operation(s) for utilities.

Scroll for all 25

Open Collections 25

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Authorization API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations DSV Cost API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations DSV Orders API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Feeds API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Fulfillment API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Insight API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Inventory API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Items API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Lag Time API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Listing Quality API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Notifications API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations On-Request Report API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations On Request Reports API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Orders API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Pre-Generated Reports API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Prices API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Promotions API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Reports API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Returns/Refunds API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Rules API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Settings API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Ship with Walmart API

OPEN COLLECTION

Walmart Cost Management Assortment Recommendations Utilities API

OPEN COLLECTION

Scroll for all 25

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Walmart Developer Portal MCP Server

Walmart runs a first-party remote MCP server on its developer portal at https://developer.walmart.com/mcp. It answers JSON-RPC over HTTP and is guarded by OAuth 2.1 (authorizati...

MCP SERVER

GraphQL 1

GraphQL schemas published by this provider.

Walmart GraphQL Schema

This conceptual GraphQL schema represents the Walmart Marketplace API surface, covering the full lifecycle of retail commerce operations available through the [Walmart Developer...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Walmart Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Walmart Rate Limits

202 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Walmart Finops

FINOPS

Features 8

Notable capabilities this provider offers.

Remote MCP server live at https://developer.walmart.com/mcp (OAuth 2.1 + PKCE, scopes openapi_read/offline_access)

202 per-operation rate limits published, token-bucket, allotted per seller; headers x-current-token-count + X-Next-Replenishment-Time

Formal four-state API deprecation guide (Active/Legacy/Deprecated/Sunset) with published sunset dates

Dated changelog, 51 entries, roughly weekly, written at operation and property granularity

No idempotency mechanism anywhere in the surface — writes are not replay-safe

No maintained first-party SDK; both walmartlabs repos are archived (2019, 2020). Walmart directs developers to OpenAPI Generator

GS1 GTIN-14 is a first-class item identifier declared in the contract, with a GTIN Exemption API for products without one

No API metering: access follows an approved seller account; referral fees 6-15% by category, no setup or monthly fee

Scroll for all 8

Event Specifications 2

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Walmart Marketplace Notifications (Webhooks)

AsyncAPI 2.6 description of the Walmart Marketplace Notifications surface — also known as Walmart's seller webhooks / push notifications. Walmart POSTs a JSON payload describing...

ASYNCAPI

Walmart Webhooks

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Walmart Context

6 classes · 17 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Walmart API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Walmart API Rules

10 rules · 4 errors 6 warnings

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

Walmart Marketplace Inventory

3 properties

JSON SCHEMA

Walmart Marketplace Order

6 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Walmart Order Structure

0 properties

JSON STRUCTURE

Examples 2

Example request and response payloads for these APIs.

Walmart Marketplace Inventory Updateinventory Example

2 fields

EXAMPLE

Walmart Marketplace Orders Listorders Example

2 fields

EXAMPLE

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Walmart Authentication

oauth2/http · 2 schemes

SECURITY

Walmart Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Walmart Vulnerability Disclosure

Hackerone · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Walmart Agentic Access

171 operations · 82 acting · 2 human-in-the-loop

171 operations · 82 acting

AGENTIC

Press 5

Recent news and press coverage referencing this provider.

Walmart is restructuring its staff to focus on expansion of AI ...

2026-05-25

Walmart Unveils New AI-Powered Tools To Empower 1.5 ...

2026-05-25

Walmart Reveals Plan for Scaling Artificial Intelligence ...

2026-05-25

Walmart and Google Turn AI Discovery Into Effortless ...

2026-05-25

Walmart Partners with OpenAI to Create AI-First Shopping ...

2026-05-25

Resources

Get Started 6

Portal, sign-up, and the first successful call

Portal

Sandbox

DeveloperPortal

GettingStarted

SignUp

Login

Documentation 4

Reference material describing how the API behaves

Documentation

APIReference

AsyncAPI

GraphQL

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

MCPServer

WellKnown

LLMsTxt

AgentSkill

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Lifecycle

ErrorCatalog

Conventions

Conformance

DataModel

Webhooks

Build 4

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

Postman

Packages

Examples

Access & Security 5

Authentication, authorization, and security posture

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

Authentication

Security

SecurityTxt

Operate 6

Status, limits, changes, and where to get help

Support

FAQ

StatusPage

Deprecation

ChangeLog

RateLimits

Commercial 4

Pricing, plans, and the legal terms of use

TermsOfService

Pricing

PrivacyPolicy

Plans

Company 3

The organization behind the API

Website

Website

LinkedIn

Blog

Blog

Other 4

Properties that don't map to a standard resource type

CapabilityMap

CapabilityMap

Whats New

Whats New

Overlay

Overlay

Source (apis.yml)

aid: walmart
url: https://raw.githubusercontent.com/api-search/commerce/main/_apis/walmart/apis.md
apis:
- aid: walmart:walmart-assortment-recommendations-api
  name: Walmart Assortment Recommendations API
  description: The Assortment Recommendations API from Walmart — 3 operation(s) for assortment recommendations.
  humanURL: https://developer.walmart.com/us-marketplace/docs/assortment-recommendations-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Assortment Recommendations
  properties:
  - type: OpenAPI
    url: openapi/walmart-assortment-recommendations-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/assortment-recommendations-overview
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/reference/getassortmentrecommendations-1
  - type: Overlay
    url: overlays/walmart-assortment-recommendations-api-overlay.yaml
- aid: walmart:walmart-authorization-api
  name: Walmart Authorization API
  description: The Authorization API from Walmart — 2 operation(s) for authorization.
  humanURL: https://developer.walmart.com/us-marketplace/docs/authentication-authorization
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Authorization
  properties:
  - type: OpenAPI
    url: openapi/walmart-authorization-api-openapi.yml
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/docs/oauth-authentication
  - type: Overlay
    url: overlays/walmart-authorization-api-overlay.yaml
- aid: walmart:walmart-dsv-cost-api
  name: Walmart DSV Cost API
  description: The DSV Cost API from Walmart — 1 operation(s) for dsv cost.
  humanURL: https://developer.walmart.com/suppliers/docs/get-started
  baseURL: https://api-gateway.walmart.com
  tags:
  - DSV Cost
  properties:
  - type: OpenAPI
    url: openapi/walmart-dsv-cost-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/suppliers/docs/get-started
  - type: Overlay
    url: overlays/walmart-dsv-cost-api-overlay.yaml
- aid: walmart:walmart-dsv-orders-api
  name: Walmart DSV Orders API
  description: The DSV Orders API from Walmart — 6 operation(s) for dsv orders.
  humanURL: https://developer.walmart.com/suppliers/docs/get-started
  baseURL: https://api-gateway.walmart.com
  tags:
  - DSV Orders
  properties:
  - type: OpenAPI
    url: openapi/walmart-dsv-orders-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/suppliers/docs/get-started
  - type: Overlay
    url: overlays/walmart-dsv-orders-api-overlay.yaml
- aid: walmart:walmart-feeds-api
  name: Walmart Feeds API
  description: The Feeds API from Walmart — 3 operation(s) for feeds.
  humanURL: https://developer.walmart.com/us-marketplace/reference/getallfeedstatuses
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Feeds
  properties:
  - type: OpenAPI
    url: openapi/walmart-feeds-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/reference/getallfeedstatuses
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/reference/getallfeedstatuses
  - type: Overlay
    url: overlays/walmart-feeds-api-overlay.yaml
- aid: walmart:walmart-fulfillment-api
  name: Walmart Fulfillment API
  description: The Fulfillment API from Walmart — 21 operation(s) for fulfillment.
  humanURL: https://developer.walmart.com/us-marketplace/docs/create-customer-order-for-wfs-item
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Fulfillment
  properties:
  - type: OpenAPI
    url: openapi/walmart-fulfillment-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/create-customer-order-for-wfs-item
  - type: Overlay
    url: overlays/walmart-fulfillment-api-overlay.yaml
- aid: walmart:walmart-insight-api
  name: Walmart Insight API
  description: The Insight API from Walmart — 7 operation(s) for insight.
  humanURL: https://developer.walmart.com/us-marketplace/docs/insights-api-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Insight
  properties:
  - type: OpenAPI
    url: openapi/walmart-insight-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/insights-api-overview
  - type: Overlay
    url: overlays/walmart-insight-api-overlay.yaml
- aid: walmart:walmart-inventory-api
  name: Walmart Inventory API
  description: The Inventory API from Walmart — 6 operation(s) for inventory.
  humanURL: https://developer.walmart.com/us-marketplace/reference/getinventory
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Inventory
  properties:
  - type: OpenAPI
    url: openapi/walmart-inventory-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/reference/getinventory
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/reference/getinventory
  - type: Overlay
    url: overlays/walmart-inventory-api-overlay.yaml
- aid: walmart:walmart-items-api
  name: Walmart Items API
  description: The Items API from Walmart — 13 operation(s) for items.
  humanURL: https://developer.walmart.com/us-marketplace/reference/getspec
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Item
  tags_raw:
  - Items
  properties:
  - type: OpenAPI
    url: openapi/walmart-items-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/reference/getspec
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/reference/getspec
  - type: Overlay
    url: overlays/walmart-items-api-overlay.yaml
- aid: walmart:walmart-lag-time-api
  name: Walmart Lag Time API
  description: The Lag Time API from Walmart — 2 operation(s) for lag time.
  humanURL: https://developer.walmart.com/us-marketplace/docs/lag-time-api-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Lag Time
  properties:
  - type: OpenAPI
    url: openapi/walmart-lag-time-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/lag-time-api-overview
  - type: Overlay
    url: overlays/walmart-lag-time-api-overlay.yaml
- aid: walmart:walmart-listing-quality-api
  name: Walmart Listing Quality API
  description: The Listing Quality API from Walmart — 3 operation(s) for listing quality.
  humanURL: https://developer.walmart.com/us-marketplace/reference/getlistingqualityscore
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Listing Quality
  properties:
  - type: OpenAPI
    url: openapi/walmart-listing-quality-api-openapi.yml
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/reference/getlistingqualityscore
  - type: Overlay
    url: overlays/walmart-listing-quality-api-overlay.yaml
- aid: walmart:walmart-notifications-api
  name: Walmart Notifications API
  description: The Notifications API from Walmart — 4 operation(s) for notifications.
  humanURL: https://developer.walmart.com/us-marketplace/docs/notifications-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Notification
  tags_raw:
  - Notifications
  properties:
  - type: OpenAPI
    url: openapi/walmart-notifications-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/notifications-overview
  - type: AsyncAPI
    url: asyncapi/walmart-marketplace-notifications-asyncapi.yml
  - type: Webhooks
    url: asyncapi/walmart-webhooks.yml
  - type: Overlay
    url: overlays/walmart-notifications-api-overlay.yaml
- aid: walmart:walmart-on-request-report-api
  name: Walmart On-Request Report API
  description: The On-Request Report API from Walmart — 3 operation(s) for on-request report.
  humanURL: https://developer.walmart.com/us-marketplace/docs/on-request-reports-api-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - On-Request Report
  properties:
  - type: OpenAPI
    url: openapi/walmart-on-request-report-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/on-request-reports-api-overview
  - type: Overlay
    url: overlays/walmart-on-request-report-api-overlay.yaml
- aid: walmart:walmart-on-request-reports-api
  name: Walmart On Request Reports API
  description: The On Request Reports API from Walmart — 3 operation(s) for on request reports.
  humanURL: https://developer.walmart.com/us-marketplace/docs/on-request-reports-api-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - On Request Reports
  properties:
  - type: OpenAPI
    url: openapi/walmart-on-request-reports-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/on-request-reports-api-overview
  - type: Overlay
    url: overlays/walmart-on-request-reports-api-overlay.yaml
- aid: walmart:walmart-orders-api
  name: Walmart Orders API
  description: The Orders API from Walmart — 7 operation(s) for orders.
  humanURL: https://developer.walmart.com/us-marketplace/reference/getallorders
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Order
  tags_raw:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/walmart-orders-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/reference/getallorders
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/reference/getallorders
  - type: Overlay
    url: overlays/walmart-orders-api-overlay.yaml
- aid: walmart:walmart-pre-generated-reports-api
  name: Walmart Pre-Generated Reports API
  description: The Pre-Generated Reports API from Walmart — 1 operation(s) for pre-generated reports.
  humanURL: https://developer.walmart.com/suppliers/docs/get-started
  baseURL: https://api-gateway.walmart.com
  tags:
  - Pre-Generated Reports
  properties:
  - type: OpenAPI
    url: openapi/walmart-pre-generated-reports-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/suppliers/docs/get-started
  - type: Overlay
    url: overlays/walmart-pre-generated-reports-api-overlay.yaml
- aid: walmart:walmart-prices-api
  name: Walmart Prices API
  description: The Prices API from Walmart — 8 operation(s) for prices.
  humanURL: https://developer.walmart.com/us-marketplace/reference/updateprice
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Prices
  properties:
  - type: OpenAPI
    url: openapi/walmart-prices-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/reference/updateprice
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/reference/updateprice
  - type: Overlay
    url: overlays/walmart-prices-api-overlay.yaml
- aid: walmart:walmart-promotions-api
  name: Walmart Promotions API
  description: The Promotions API from Walmart — 3 operation(s) for promotions.
  humanURL: https://developer.walmart.com/us-marketplace/reference/updatepromotionalprices
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Promotions
  properties:
  - type: OpenAPI
    url: openapi/walmart-promotions-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/reference/updatepromotionalprices
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/reference/updatepromotionalprices
  - type: Overlay
    url: overlays/walmart-promotions-api-overlay.yaml
- aid: walmart:walmart-reports-api
  name: Walmart Reports API
  description: The Reports API from Walmart — 7 operation(s) for reports.
  humanURL: https://developer.walmart.com/us-marketplace/docs/on-request-reports-api-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Reports
  properties:
  - type: OpenAPI
    url: openapi/walmart-reports-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/on-request-reports-api-overview
  - type: Overlay
    url: overlays/walmart-reports-api-overlay.yaml
- aid: walmart:walmart-returns-refunds-api
  name: Walmart Returns/Refunds API
  description: The Returns/Refunds API from Walmart — 3 operation(s) for returns/refunds.
  humanURL: https://developer.walmart.com/us-marketplace/reference/issuerefund
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Returns/Refunds
  properties:
  - type: OpenAPI
    url: openapi/walmart-returns-refunds-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/reference/issuerefund
  - type: APIReference
    url: https://developer.walmart.com/us-marketplace/reference/issuerefund
  - type: Overlay
    url: overlays/walmart-returns-refunds-api-overlay.yaml
- aid: walmart:walmart-reviews-api
  name: Walmart Reviews API
  description: The Reviews API from Walmart — 3 operation(s) for reviews.
  humanURL: https://developer.walmart.com/us-marketplace/docs/reviews-api-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Reviews
  properties:
  - type: OpenAPI
    url: openapi/walmart-reviews-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/reviews-api-overview
  - type: Overlay
    url: overlays/walmart-reviews-api-overlay.yaml
- aid: walmart:walmart-rules-api
  name: Walmart Rules API
  description: The Rules API from Walmart — 14 operation(s) for rules.
  humanURL: https://developer.walmart.com/us-marketplace/docs/introduction-to-marketplace-apis
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Rules
  properties:
  - type: OpenAPI
    url: openapi/walmart-rules-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/introduction-to-marketplace-apis
  - type: Overlay
    url: overlays/walmart-rules-api-overlay.yaml
- aid: walmart:walmart-settings-api
  name: Walmart Settings API
  description: The Settings API from Walmart — 11 operation(s) for settings.
  humanURL: https://developer.walmart.com/us-marketplace/docs/shipping-and-fulfillment-settings-api-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Settings
  properties:
  - type: OpenAPI
    url: openapi/walmart-settings-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/shipping-and-fulfillment-settings-api-overview
  - type: Overlay
    url: overlays/walmart-settings-api-overlay.yaml
- aid: walmart:walmart-ship-with-walmart-api
  name: Walmart Ship with Walmart API
  description: The Ship with Walmart API from Walmart — 7 operation(s) for ship with walmart.
  humanURL: https://developer.walmart.com/us-marketplace/docs/buy-shipping
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Ship with Walmart
  properties:
  - type: OpenAPI
    url: openapi/walmart-ship-with-walmart-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/buy-shipping
  - type: Overlay
    url: overlays/walmart-ship-with-api-overlay.yaml
- aid: walmart:walmart-utilities-api
  name: Walmart Utilities API
  description: The Utilities API from Walmart — 4 operation(s) for utilities.
  humanURL: https://developer.walmart.com/us-marketplace/docs/utilities-overview
  baseURL: https://marketplace.walmartapis.com
  tags:
  - Utilities
  properties:
  - type: OpenAPI
    url: openapi/walmart-utilities-api-openapi.yml
  - type: Documentation
    url: https://developer.walmart.com/us-marketplace/docs/utilities-overview
  - type: Overlay
    url: overlays/walmart-utilities-api-overlay.yaml
name: Walmart
tags:
- Commerce
- Retail
- Fortune 100
- Marketplace
- E-Commerce
- Order
- Inventory
- Fulfillment
- Supply Chain
- Seller APIs
- Webhook
- MCP
tags_raw:
- Commerce
- Retail
- Fortune 100
- Marketplace
- E-Commerce
- Orders
- Inventory
- Fulfillment
- Supply Chain
- Seller APIs
- Webhooks
- MCP
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: enterprise
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Enterprise · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/walmart.png
common:
- type: Website
  url: https://www.walmart.com/
- type: CapabilityMap
  url: capabilities/walmart-capability-edges.yml
  name: Walmart Business Capability Map
- type: AgenticAccess
  url: agentic-access/walmart-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/walmart-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/walmart-domain-security.yml
- type: Authentication
  url: authentication/walmart-authentication.yml
- type: GitHubOrganization
  url: https://github.com/walmartlabs
- type: LinkedIn
  url: https://www.linkedin.com/company/walmart
- url: https://developer.walmart.com/
  type: Portal
- url: https://developer.walmart.com/us-marketplace/docs/introduction-to-marketplace-apis
  type: Documentation
- url: https://developer.walmart.com/us-marketplace/docs/walmart-api-sandbox
  type: Sandbox
- url: https://developer.walmart.com/us-marketplace/page/whats-new
  type: Whats New
- url: https://developer.walmart.com/us-marketplace/docs/troubleshooting-and-support
  type: Support
- url: https://developer.walmart.com/us-marketplace/docs/frequently-asked-questions-faqs
  type: FAQ
- url: https://developer.walmart.com/api-status
  type: StatusPage
- url: https://developer.walmart.com/us-marketplace/page/terms-and-conditions
  type: TermsOfService
- type: Summary
  data:
    numberOfAPITags: 2
    numberOfAPIProperties: 0
    numberOfAPIPaths: 0
    numberOfAPIGetMethods: 0
    numberOfAPIPostMethods: 0
    numberOfAPIPutMethods: 0
    numberOfAPIPatchMethods: 0
    numberOfAPIDeleteMethods: 0
    numberOfAPIOptionMethods: 0
    numberOfAPIParameters: 0
    numberOfAPISchema: 0
- type: Features
  data:
  - Remote MCP server live at https://developer.walmart.com/mcp (OAuth 2.1 + PKCE, scopes openapi_read/offline_access)
  - 202 per-operation rate limits published, token-bucket, allotted per seller; headers x-current-token-count + X-Next-Replenishment-Time
  - Formal four-state API deprecation guide (Active/Legacy/Deprecated/Sunset) with published sunset dates
  - Dated changelog, 51 entries, roughly weekly, written at operation and property granularity
  - No idempotency mechanism anywhere in the surface — writes are not replay-safe
  - No maintained first-party SDK; both walmartlabs repos are archived (2019, 2020). Walmart directs developers to OpenAPI
    Generator
  - GS1 GTIN-14 is a first-class item identifier declared in the contract, with a GTIN Exemption API for products without
    one
  - 'No API metering: access follows an approved seller account; referral fees 6-15% by category, no setup or monthly fee'
  sources:
  - https://developer.walmart.com/us-marketplace/docs/rate-limiting
  - https://developer.walmart.com/us-marketplace/docs/walmart-marketplace-api-deprecation-guide
  - https://developer.walmart.com/mcp
  - https://marketplace.walmart.com/pricing/
  updated: '2026-08-27'
- type: DeveloperPortal
  url: https://developer.walmart.com/
- type: APIReference
  url: https://developer.walmart.com/us-marketplace/reference/getallorders
- type: GettingStarted
  url: https://developer.walmart.com/us-marketplace/page/getting-started
- type: Blog
  url: https://tech.walmart.com/content/walmart-global-tech/en_us/blog.html
- type: Postman
  url: https://developer.walmart.com/us-marketplace/page/walmart-api-postman-collection
- type: Pricing
  url: https://marketplace.walmart.com/pricing/
- type: SignUp
  url: https://marketplace.walmart.com/apply/
- type: Login
  url: https://developer.walmart.com/account/generateKey
- type: PrivacyPolicy
  url: https://corporate.walmart.com/privacy-security
- type: Deprecation
  url: https://developer.walmart.com/us-marketplace/docs/walmart-marketplace-api-deprecation-guide
- type: ChangeLog
  url: changelog/walmart-changelog.yml
- type: Security
  url: https://corporate.walmart.com/article/responsible-disclosure-policy
- type: Lifecycle
  url: lifecycle/walmart-lifecycle.yml
- type: RateLimits
  url: rate-limits/walmart-rate-limits.yml
- type: Plans
  url: plans/walmart-plans-pricing.yml
- type: ErrorCatalog
  url: errors/walmart-problem-types.yml
- type: Conventions
  url: conventions/walmart-conventions.yml
- type: Conformance
  url: conformance/walmart-conformance.yml
- type: MCPServer
  url: mcp/walmart-mcp.yml
- type: WellKnown
  url: well-known/walmart-well-known.yml
- type: SecurityTxt
  url: well-known/walmart-security.txt
- type: LLMsTxt
  url: llms/walmart-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: DataModel
  url: data-model/walmart-data-model.yml
- type: Packages
  url: packages/walmart-packages.yml
- type: AsyncAPI
  url: asyncapi/walmart-marketplace-notifications-asyncapi.yml
- type: Webhooks
  url: asyncapi/walmart-webhooks.yml
- type: GraphQL
  url: graphql/walmart-graphql.md
- type: Overlay
  url: overlays/walmart-orders-api-overlay.yaml
- type: Examples
  url: examples/walmart-marketplace-orders-listOrders-example.json
created: 2023/11/15
modified: '2026-08-27'
description: Walmart is a multinational retail corporation that operates a chain of hypermarkets, discount department stores,
  and grocery stores. The company is known for offering a wide range of products at competitive prices, attracting customers
  from all walks of life. Walmart also provides various convenience services, such as pharmacy, optical, and financial services,
  making it a one-stop shop for many consumers. The Walmart Marketplace APIs enable third-party sellers to list and sell products,
  manage orders, inventory, pricing, fulfillment, and reporting on Walmart.com.
artifacts:
- url: rules/walmart-rules.yml
  type: SpectralRules
- url: json-schema/walmart-order-schema.json
  type: JSONSchema
- url: json-schema/walmart-inventory-schema.json
  type: JSONSchema
- url: json-ld/walmart-context.jsonld
  type: JSONLDContext
- url: vocabulary/walmart-vocabulary.yml
  type: Vocabulary
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.23'
kind: contract
position: Consuming
access: 3rd-Party
x-enrichment:
  date: '2026-08-27'
  status: enriched
  artifacts_added: 47
  pass: local-v1

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/walmart"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/walmart/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/walmart/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.