Error codes

Migrate to Global APIs: New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities. The Canada Legacy APIs are being deprecated, and this documentation will be archived soon. Plan your migration accordingly. Explore Global Marketplace migration resources.


A basic HTTP error code (such as 503 Service Unavailable) is returned if an API call cannot reach the Walmart gateway. However, a complete error response object is returned if the gateway is reached.

The error response message includes this information:

  1. The error code name (such as INVALID_REQUEST).

  2. The HTTP status code ( 400 or 401).

  3. The reason for the error can be in either of these categories: Application, Data, or System.

  4. The severity of the error is either Info or Error.

  5. If the error response includes a field tag, it will be true or false.

Error CodeHTTP StatusCategorySeverityField Included
SOME_CONTENT_NOT_FOUND206Application
INVALID_REQUEST400DataErrortrue
INVALID_REQUEST_HEADER400DataErrortrue
INVALID_REQUEST_PARAM400DataErrortrue
INVALID_REQUEST_CONTENT400DataErrortrue
MISSING_REQUEST_HEADER400DataErrortrue
MISSING_REQUEST_PARAM400DataErrortrue
MALFORMED_REQUEST_CONTENT400DataErrortrue
UNAUTHORIZED401DataErrorfalse
FORBIDDEN.GMP_GATEWAY_API403DataErrorfalse
CONTENT_NOT_FOUND404ApplicationInfofalse
URI_NOT_FOUND404DataErrorfalse
METHOD_NOT_ALLOWED405DataErrorfalse
INVALID_ACCEPT_TYPE406ApplicationErrorfalse
UNSUPPORTED_MEDIA_TYPE415DataErrorfalse
RESOURCE_IS_LOCKED.GMP_RECEIVER_API423ApplicationErrorfalse
REQUEST_THRESHOLD_VIOLATED429RequestErrorfalse
INVALID_SYSTEM_STATE500SystemErrorfalse
SYSTEM_ERROR500SystemErrorfalse
DOWNSTREAM_SYSTEM_TIME_OUT504SystemErrorfalse

For example, the last error object on the right contains an INVALID_REQUEST_HEADER error encountered when invoking the GMP_ORDER_API. The error is a DATA ERROR in the WM_QOS. The CORRELATION_ID field (a request header) is null or blank.

Sample errors object

<?xml version="1.0" encoding="UTF-8"?>
<errors> <error> <code>INVALID_REQUEST_HEADER.GMP_ORDER_API</code> <field>WM_SVC.ENV</field> <description>WM_SVC.ENV set blank or null</description> <info>One or more request headers are invalid.</info> <severity>ERROR</severity> <category>DATA</category> <causes></causes> <errorIdentifiers></errorIdentifiers> </error> <error> <code>INVALID_REQUEST_HEADER.GMP_ORDER_API</code> <field>WM_CONSUMER.ID</field> <description>WM_CONSUMER.ID set blank or null</description> <info>One or more request headers are invalid.</info> <severity>ERROR</severity> <category>DATA</category> <causes></causes> <errorIdentifiers></errorIdentifiers> </error> <error> <code>INVALID_REQUEST_HEADER.GMP_ORDER_API </code> <field>WM_SVC.NAME</field> <description>WM_SVC.NAME set blank or null</description> <info>One or more request headers are invalid.</info> <severity>ERROR</severity> <category>DATA</category> <causes></causes> <errorIdentifiers></errorIdentifiers> </error> <error> <code>INVALID_REQUEST_HEADER.GMP_ORDER_API</code> <field>WM_QOS.CORRELATION_ID</field> <description>WM_QOS.CORRELATION_ID set blank or null </description> <info>One or more request headers are invalid.</info> <severity>ERROR</severity> <category>DATA</category> <causes></causes> <errorIdentifiers></errorIdentifiers> </error>
</errors>

Did this page help you?