Guides
My Account

API integration & usage

How do I make my first API call in Walmart Marketplace?

  1. Get an OAuth access token for the correct environment (sandbox or production).

    Sandbox URL - https://sandbox.walmartapis.com

    Production URL - https://marketplace.walmartapis.com

    API - Token API (OAuth2.0)

  2. Run a quick read to confirm connectivity (in sandbox). Good first checks are listing items or checking a recent feed/job.

    APIs - Item Management (list/search items); Feed Management (get feed item status)

  3. Try one safe write on a test SKU in sandbox, for example update price or update inventory.

    APIs - Price management (update price) or Inventory management (update inventory).

  4. Create item content at scale using a catalog feed, then make it buyable by setting an offer (price + inventory).

    APIs - Item management (Bulk item setup); Price management (Update pricing for a single item); Inventory Management(Update inventory

  5. Verify that the item content is published, active and searchable. For example review if price set and inventory is greater than 0.

  6. APIs - Retrieve item details (All items) or search by SKU (Single item inventory by ship node) to confirm published status.

What are common API error codes and how do I resolve them?

  1. 400 – invalid request: Malformed JSON/XML, wrong Content-Type, missing required fields/params, or calling before an item has been ingested.

    Fix: Validate payloads against the latest schema/spec, set headers correctly, include required fields, and ensure the item has completed ingestion.

  2. 401 – unauthorized: Expired/invalid token, wrong keys or environment, missing/invalid signature or access-token header.

    Fix: Renew the token, confirm sandbox/production URLs and credentials match, and verify any required headers/signature.

  3. 403 – forbidden: Missing scope/permission for the endpoint/resource.

    Fix: Update app roles/scopes and reauthorize if required.

  4. 404 – resource not found: This typically indicates that the item or offer hasn't completed ingestion.

    Fix: Check item status (for example, via GetItemDetails). If status is “InProgress,” wait and retry. If nonexistent, create/ingest first.

  5. 429 – too many requests: Throttling/rate limits exceeded.

    Fix: The Marketplace APIs enforce throttling and rate limits. Respect rate- limit headers such as x-current-token-count and x-next-replenish-time. Throttle requests and use exponential backoff with jitter to avoid overload.

How do I manage rate limits and throttling? Respect rate-limit or usage headers when present. For example, remaining quota, next replenish time. Implement exponential backoff with jitter and honor Retry-After. Batch bulk changes via feeds; keep order/offer updates small and frequent. For the detailed throttling or API rate limits for Marketplace APIs, refer to the Marketplace Rate Limiting Guide.
Where can I find examples or sample payloads? The Marketplace API reference and Marketplace API Guide pages include request and response samples. You can also use Postman collections or curl snippets.

Updated about 21 hours ago