Guides
My Account

Troubleshooting and support

My API call is failing. Where should I start?

Start with these checks:

  • Check the HTTP status code and error response body.
  • Verify the access token (correct environment, not expired, required scopes included).
  • Validate the request payload against the latest API schema or specification.
  • Reproduce the issue with a minimal cURL request.
  • Capture the correlation ID (or request ID) and timestamp (UTC) before contacting support.

My feed fails with 'Malformed data' or ERR_PDI_0001 / ERR_PDI_0034. What should I do?

These errors indicate issues with the feed file, such as missing required elements, invalid characters, or incorrect field values.

Recommended steps:

  • Validate the feed file against the latest XSD or API specification.
  • Remove unsupported or invalid characters.
  • Ensure all required fields are present and properly formatted.
  • Review error details in the feed status response to identify the exact failing element.
  • Resubmit the corrected feed.

How can I check if an API service is down or degraded?

Check the Walmart API Status page for real-time service health and incident updates: https://developer.walmart.com/api-status

Persistent 500 or 503 errors may indicate temporary service disruption or degradation.

Recommended steps:

  • Retry the request after some time.
  • Monitor the API status page for active incidents.
  • If the issue persists and there are no active incidents, contact support with details including correlation ID(s), UTC timestamps, and error responses from your failed requests.

What are common issues during item setup (cataloging)?

Common cataloging issues include:

  • Invalid GTIN/UPC formats and lengths
  • Conflicting product data (for example, mismatched titles, descriptions, or pricing data).
  • Using outdated item specification versions.
  • Missing required attributes.

To prevent these issues, always use the latest item specification and ensure product data accuracy.

Refer to the Feed files available guide to review requirements and download the latest item specification.

Sandbox and production return different results. What should I do?

First, confirm you are using the correct base URL and credentials for each environment:

Some validations or latency behaviors may differ in sandbox. Always re-test critical workflows in production using a small test rollout before scaling.

Why did my Solution Provider app connection stop working?

Solution Provider app connections expire after one year and must be reauthorized.

Check the following:

  • OAuth 2.0 scopes are still valid.
  • Credentials (Consumer ID / Private Key) have not been revoked.

Additional best practices:

  • Include correlation IDs (WM_QOS.CORRELATION_ID) in requests to assist support.
  • Avoid concurrent updates to the same SKU to prevent "Resource Is Locked (423)" errors.
  • Track item specification version updates to prevent validation failures: https://developer.walmart.com/suppliers/docs/feed-files-available
  • Monitor API traffic and recurring 4xx errors to identify systemic issues early.

When should I contact Supplier Help?

Contact Supplier Help when issues persist after verifying tokens, headers, and permissions.

Contact Supplier Help for:

  • Persistent authentication or authorization issues.
  • Unexplained errors after verifying request correctness.
  • Suspected platform incidents (for example, widespread 5xx errors or latency) that are not reflected on the API status page.
  • Assistance with interpreting error responses or troubleshooting specific API issues.

How do I contact Supplier Help?

Open a ticket via Supplier Help.

Include the following details to help expedite investigation:

  • Environment (Sandbox or Production)
  • Endpoint
  • Full request and response (sanitized; do not include credentials)
  • Correlation ID or request ID
  • Timestamps (UTC)
  • Frequency (one-off vs recurring pattern)

For suspected platform incidents (for example, widespread 5xx errors or latency), check the status or health page first before submitting a ticket.

Where can I check the Walmart API system status?

The Walmart API Status page shows the health of our services. You can view the uptime, incidents, and scheduled maintenance in one place. You can subscribe to email and SMS updates alerting you to API incidents and their resolutions.

The page is public so you can check it even if you cannot sign in. We post updates during incidents and notify affected customers when possible. Historical data is available so you can review past performance.

If you are experiencing API errors, review the response status code and error payload for details.

For widespread issues (for example, elevated 5xx errors or latency), consult the API Status page before opening a support ticket.

How do I report an API issue?

If you encounter an API issue, collect the following before contacting support:

  • Endpoint URL
  • Request method
  • Request headers (excluding sensitive credentials)
  • Sample payload
  • Full error response
  • Correlation or request ID.

Report the issue in Supplier Help to help expedite troubleshooting.


Updated about 10 hours ago