---
updatedAt: 2026-08-03T18:18:58.000Z
---

# Error codes

 <div class="amber-callout" aria-label="Migration notice"><p><strong>Migrate to Global APIs:</strong> New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore <a href ="https://developer.walmart.com/global-marketplace/docs/global-marketplace-apis" style="text-decoration: underline !important; font-weight: 700;">Global Marketplace migration resources</a>.</p></div> 

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 Code                              | HTTP Status | Category    | Severity | Field Included |
| --------------------------------------- | ----------- | ----------- | -------- | -------------- |
| SOME\_CONTENT\_NOT\_FOUND               | 206         | Application |          |                |
| INVALID\_REQUEST                        | 400         | Data        | Error    | true           |
| INVALID\_REQUEST\_HEADER                | 400         | Data        | Error    | true           |
| INVALID\_REQUEST\_PARAM                 | 400         | Data        | Error    | true           |
| INVALID\_REQUEST\_CONTENT               | 400         | Data        | Error    | true           |
| MISSING\_REQUEST\_HEADER                | 400         | Data        | Error    | true           |
| MISSING\_REQUEST\_PARAM                 | 400         | Data        | Error    | true           |
| MALFORMED\_REQUEST\_CONTENT             | 400         | Data        | Error    | true           |
| UNAUTHORIZED                            | 401         | Data        | Error    | false          |
| FORBIDDEN.GMP\_GATEWAY\_API             | 403         | Data        | Error    | false          |
| CONTENT\_NOT\_FOUND                     | 404         | Application | Info     | false          |
| URI\_NOT\_FOUND                         | 404         | Data        | Error    | false          |
| METHOD\_NOT\_ALLOWED                    | 405         | Data        | Error    | false          |
| INVALID\_ACCEPT\_TYPE                   | 406         | Application | Error    | false          |
| UNSUPPORTED\_MEDIA\_TYPE                | 415         | Data        | Error    | false          |
| RESOURCE\_IS\_LOCKED.GMP\_RECEIVER\_API | 423         | Application | Error    | false          |
| REQUEST\_THRESHOLD\_VIOLATED            | 429         | Request     | Error    | false          |
| INVALID\_SYSTEM\_STATE                  | 500         | System      | Error    | false          |
| SYSTEM\_ERROR                           | 500         | System      | Error    | false          |
| DOWNSTREAM\_SYSTEM\_TIME\_OUT           | 504         | System      | Error    | false          |

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>
```