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 1 day ago