---
updatedAt: 2026-04-12T09:29:49.000Z
---

# Dispute status

Retrieve the duplicate dispute status for up to 100 items.

Provide `productId` and `productIdType` for each item in the request body. Typical HTTP outcomes: 200 (all items processed), 206 (partial content), 404 (no item found). Item status values may include: IN_REVIEW, IS_DUPLICATE, NOT_DUPLICATE, ERROR.

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-41c3e1d6-f431-4c57-a3d6-6dab5bca6da9?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-41c3e1d6-f431-4c57-a3d6-6dab5bca6da9%26entityType%3Dcollection%26workspaceId%3De352a845-5a81-4cbe-9122-9b33bac31bf3\"\n  target=\"_blank\"\n  style=\"text-decoration: none\"\n>\n  <button>\n    <img\n      src=\"https://run.pstmn.io/button.svg\"\n      alt=\"Run In Postman\"\n      style=\"width: 128px; height: 32px\"\n    />\n  </button>\n</a>"
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Disputes Management",
    "version": "1.0",
    "description": "The Dispute Management APIs allows you to submit duplicate-listing disputes and check status for up to 100 items per request. For details on throttling, refer to the <a href=\"https://developer.walmart.com/us-marketplace/docs/rate-limiting\">Walmart throttling documentation</a>."
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production environment base URL"
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Sandbox environment base URL"
    }
  ],
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false,
    "explorer-enabled": true
  },
  "paths": {
    "/v3/items/dispute/duplicates/status": {
      "post": {
        "tags": [
          "Disputes"
        ],
        "summary": "Dispute status",
        "description": "Retrieve the duplicate dispute status for up to 100 items.\n\nProvide `productId` and `productIdType` for each item in the request body. Typical HTTP outcomes: 200 (all items processed), 206 (partial content), 404 (no item found). Item status values may include: IN_REVIEW, IS_DUPLICATE, NOT_DUPLICATE, ERROR.",
        "externalDocs": {
          "description": "View Guide",
          "url": "/doc/us/mp/us-mp-disputes/"
        },
        "operationId": "postStatus",
        "parameters": [
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "description": "Access token obtained from the Token API. Required for authenticating requests.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "Unique ID that represents the consumer request channel. Use the channel type provided during onboarding.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "description": "Unique ID for each API call used for tracking and debugging. Use a randomly generated GUID.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SVC.NAME",
            "description": "Name of the Walmart service being called.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Marketplace"
          }
        ],
        "x-readme": {
          "code-samples": [
            {
              "language": "curl",
              "code": "curl -X 'POST' \n  'https://marketplace.walmartapis.com/v3/items/dispute/duplicates/status' \\ \n  -H 'accept: application/json' \\ \n  -H 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \\ \n  -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \\ \n  -H 'WM_SVC.NAME: Walmart Service Name' \\ \n  -H 'Content-Type: application/xml' \n  -d '<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<DisputeContestRequest>\n<Issues>\n<productId>string</productId>\n<productIdType>string</productIdType>\n</Issues>\n</DisputeContestRequest>'",
              "name": "xml example"
            },
            {
              "language": "curl",
              "code": "curl -X 'POST'  \n  'http://marketplace.walmartapis.com/v3/items/dispute/duplicates/status' \n  -H 'accept: application/json' \n   -H 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \n   -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \n   -H 'WM_SVC.NAME: Walmart Service Name' \n   -H 'Content-Type: application/json'  \n -d'{\n\"issues\":[\n{\n\"productId\":\"string\",\n\"productIdType\":\"string\"\n}]}'",
              "name": "JSON example"
            }
          ]
        },
        "requestBody": {
          "description": "Request body containing items to check or contest for duplicates (maximum 100).",
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "issues"
                ],
                "type": "object",
                "properties": {
                  "issues": {
                    "type": "array",
                    "description": "List of items to process.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "productId": {
                          "type": "string",
                          "description": "Product ID of the item."
                        },
                        "productIdType": {
                          "type": "string",
                          "description": "Type of product identifier. Allowed values may include: WPID, GTIN, UPC, EAN, SKU."
                        }
                      },
                      "description": "Item to process in the request.",
                      "xml": {
                        "name": "Issues"
                      }
                    }
                  }
                },
                "xml": {
                  "name": "DisputeContestRequest"
                }
              }
            },
            "application/xml": {
              "schema": {
                "required": [
                  "issues"
                ],
                "type": "object",
                "properties": {
                  "issues": {
                    "type": "array",
                    "description": "List of items to process.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "productId": {
                          "type": "string",
                          "description": "Product ID of the item."
                        },
                        "productIdType": {
                          "type": "string",
                          "description": "Type of product identifier. Allowed values may include: WPID, GTIN, UPC, EAN, SKU."
                        }
                      },
                      "description": "Item to process in the request.",
                      "xml": {
                        "name": "Issues"
                      }
                    }
                  }
                },
                "xml": {
                  "name": "DisputeContestRequest"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Response received for all items.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "itemResponse"
                  ],
                  "type": "object",
                  "properties": {
                    "itemResponse": {
                      "type": "array",
                      "description": "Statuses for the requested items.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "productId": {
                            "type": "string",
                            "description": "Walmart product ID assigned when the item is listed on Walmart.com."
                          },
                          "productIdType": {
                            "type": "string",
                            "description": "Type of product identifier. Allowed values may include: WPID, GTIN, UPC, EAN, SKU."
                          },
                          "status": {
                            "type": "string",
                            "description": "Dispute processing status for the item. Allowed values may include: IN_REVIEW, IS_DUPLICATE, NOT_DUPLICATE, ERROR, PROCESSING, COMPLETED."
                          },
                          "lastUpdatedDate": {
                            "type": "string",
                            "description": "Unix epoch timestamp (milliseconds) when the item status was last updated."
                          }
                        },
                        "description": "Status of a single item.",
                        "xml": {
                          "name": "DisputeContestResponse"
                        }
                      }
                    }
                  },
                  "xml": {
                    "name": "DisputeStatusResponses"
                  }
                },
                "example": {
                  "itemResponse": [
                    {
                      "productId": "3V47ZGPR09H5",
                      "productIdType": "WPID",
                      "status": "IN_REVIEW",
                      "lastUpdatedDate": "<TIMESTAMP: Unix Epoch timestamp>"
                    },
                    {
                      "productId": "12G6TANIZ4WR",
                      "productIdType": "WPID",
                      "status": "PROCESSING",
                      "lastUpdatedDate": "<TIMESTAMP: Unix Epoch timestamp>"
                    },
                    {
                      "productId": "9JX7AGCLSR8H",
                      "productIdType": "WPID",
                      "status": "ERROR",
                      "lastUpdatedDate": "<TIMESTAMP: Unix Epoch timestamp>"
                    },
                    {
                      "productId": "12G6TANIZ4WR",
                      "productIdType": "WPID",
                      "status": "COMPLETED",
                      "lastUpdatedDate": "<TIMESTAMP: Unix Epoch timestamp>"
                    }
                  ]
                }
              },
              "application/xml": {
                "schema": {
                  "required": [
                    "itemResponse"
                  ],
                  "type": "object",
                  "properties": {
                    "itemResponse": {
                      "type": "array",
                      "description": "Statuses for the requested items.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "productId": {
                            "type": "string",
                            "description": "Walmart product ID assigned when the item is listed on Walmart.com."
                          },
                          "productIdType": {
                            "type": "string",
                            "description": "Type of product identifier. Allowed values may include: WPID, GTIN, UPC, EAN, SKU."
                          },
                          "status": {
                            "type": "string",
                            "description": "Dispute processing status for the item. Allowed values may include: IN_REVIEW, IS_DUPLICATE, NOT_DUPLICATE, ERROR, PROCESSING, COMPLETED."
                          },
                          "lastUpdatedDate": {
                            "type": "string",
                            "description": "Unix epoch timestamp (milliseconds) when the item status was last updated."
                          }
                        },
                        "description": "Status of a single item.",
                        "xml": {
                          "name": "DisputeContestResponse"
                        }
                      }
                    }
                  },
                  "xml": {
                    "name": "DisputeStatusResponses"
                  }
                },
                "example": "<DisputeStatusResponse>\n<itemResponse>\n    <itemResponse>\n        <productId>3V47ZGPR09H5</productId>\n        <productIdType>WPID</productIdType>\n        <status>IN_REVIEW</status>\n        <lastUpdatedDate>TIMESTAMP: Unix Epoch timestamp</lastUpdatedDate>\n    </itemResponse>\n    <itemResponse>\n        <productId>12G6TANIZ4WR</productId>\n        <productIdType>WPID</productIdType>\n        <status>PROCESSING</status>\n        <lastUpdatedDate>TIMESTAMP: Unix Epoch timestamp</lastUpdatedDate>\n    </itemResponse>\n    <itemResponse>\n        <productId>9JX7AGCLSR8H</productId>\n        <productIdType>WPID</productIdType>\n        <status>ERROR</status>\n        <lastUpdatedDate>TIMESTAMP: Unix Epoch timestamp</lastUpdatedDate>\n    </itemResponse>\n    <itemResponse>\n        <productId>12G6TANIZ4WR</productId>\n        <productIdType>WPID</productIdType>\n        <status>PROCESSING</status>\n        <lastUpdatedDate>TIMESTAMP: Unix Epoch timestamp</lastUpdatedDate>\n    </itemResponse>\n</itemResponse>\n</DisputeStatusResponse>"
              }
            }
          },
          "206": {
            "description": "Partial response received.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "itemResponse": {
                      "type": "array",
                      "description": "Statuses returned for items that were processed.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "productId": {
                            "type": "string",
                            "description": "Product ID of the item.",
                            "example": "3V47ZGPR09H5"
                          },
                          "productIdType": {
                            "type": "string",
                            "description": "Type of product identifier.",
                            "example": "WPID"
                          },
                          "status": {
                            "type": "string",
                            "description": "Dispute processing status for the item.",
                            "example": "IN_REVIEW"
                          },
                          "lastUpdatedDate": {
                            "type": "string",
                            "description": "Unix epoch timestamp (milliseconds) when the item status was last updated.",
                            "example": "<TIMESTAMP: Unix Epoch timestamp>"
                          }
                        },
                        "description": "Status of a single item."
                      }
                    }
                  }
                }
              },
              "application/xml": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "itemResponse": {
                      "type": "array",
                      "description": "Statuses returned for items that were processed.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "productId": {
                            "type": "string",
                            "description": "Product ID of the item.",
                            "example": "3V47ZGPR09H5"
                          },
                          "productIdType": {
                            "type": "string",
                            "description": "Type of product identifier.",
                            "example": "WPID"
                          },
                          "status": {
                            "type": "string",
                            "description": "Dispute processing status for the item.",
                            "example": "IN_REVIEW"
                          },
                          "lastUpdatedDate": {
                            "type": "string",
                            "description": "Unix epoch timestamp (milliseconds) when the item status was last updated.",
                            "example": "<TIMESTAMP: Unix Epoch timestamp>"
                          }
                        },
                        "description": "Status of a single item."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No item response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Machine-readable error code. \n",
                      "example": "URI_NOT_FOUND.GMP_ITEM_QUERY_API"
                    },
                    "description": {
                      "type": "string",
                      "description": "Human-readable error description.\n\n",
                      "example": "HTTP 404 Not Found"
                    },
                    "info": {
                      "type": "string",
                      "description": "Additional details about the error.\n\n",
                      "example": "Requested URI could not be found."
                    },
                    "severity": {
                      "type": "string",
                      "description": "Error severity.\n\nExample: ERROR\n",
                      "example": "ERROR"
                    },
                    "category": {
                      "type": "string",
                      "description": "Error category.\n\nExample: DATA\n",
                      "example": "DATA"
                    },
                    "causes": {
                      "type": "array",
                      "description": "List of contributing causes.",
                      "example": [],
                      "items": {
                        "type": "string",
                        "description": "Cause entry.",
                        "example": "[]"
                      }
                    },
                    "errorIdentifiers": {
                      "type": "object",
                      "description": "Key-value identifiers that help correlate related errors.",
                      "example": {}
                    }
                  }
                }
              },
              "application/xml": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Machine-readable error code. \n",
                      "example": "URI_NOT_FOUND.GMP_ITEM_QUERY_API"
                    },
                    "description": {
                      "type": "string",
                      "description": "Human-readable error description.\n\n",
                      "example": "HTTP 404 Not Found"
                    },
                    "info": {
                      "type": "string",
                      "description": "Additional details about the error.\n\n",
                      "example": "Requested URI could not be found."
                    },
                    "severity": {
                      "type": "string",
                      "description": "Error severity.\n\nExample: ERROR\n",
                      "example": "ERROR"
                    },
                    "category": {
                      "type": "string",
                      "description": "Error category.\n\nExample: DATA\n",
                      "example": "DATA"
                    },
                    "causes": {
                      "type": "array",
                      "description": "List of contributing causes.",
                      "example": [],
                      "items": {
                        "type": "string",
                        "description": "Key-value identifiers that help correlate related errors.",
                        "example": "[]"
                      }
                    },
                    "errorIdentifiers": {
                      "type": "object",
                      "description": "Error Identifiers of the error.",
                      "example": {}
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "HTTP status code or service error code.",
                      "example": "500"
                    },
                    "description": {
                      "type": "string",
                      "description": "Human-readable error description.\n\n",
                      "example": "Some error occurred"
                    },
                    "severity": {
                      "type": "string",
                      "description": "Error severity.\n\nExample: ERROR\n",
                      "example": "ERROR"
                    },
                    "category": {
                      "type": "string",
                      "description": "Error category.\n\nExample: REQUEST\n",
                      "example": "REQUEST"
                    },
                    "causes": {
                      "type": "array",
                      "description": "List of contributing causes.",
                      "example": [],
                      "items": {
                        "type": "string",
                        "description": "Cause entry.",
                        "example": "[]",
                        "xml": {
                          "name": "causes"
                        }
                      }
                    },
                    "errorIdentifiers": {
                      "type": "object",
                      "description": "Key-value identifiers that help correlate related errors.",
                      "example": {}
                    }
                  },
                  "xml": {
                    "name": "Error500ForDisputes"
                  }
                }
              },
              "application/xml": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "HTTP status code or service error code.",
                      "example": "500"
                    },
                    "description": {
                      "type": "string",
                      "description": "Human-readable error description.\n\n",
                      "example": "Some error occurred"
                    },
                    "severity": {
                      "type": "string",
                      "description": "Error severity.\n\nExample: ERROR\n",
                      "example": "ERROR"
                    },
                    "category": {
                      "type": "string",
                      "description": "Error category.\n\nExample: REQUEST\n",
                      "example": "REQUEST"
                    },
                    "causes": {
                      "type": "array",
                      "description": "List of contributing causes.",
                      "example": [],
                      "items": {
                        "type": "string",
                        "description": "Cause entry.",
                        "example": "[]",
                        "xml": {
                          "name": "causes"
                        }
                      }
                    },
                    "errorIdentifiers": {
                      "type": "object",
                      "description": "Key-value identifiers that help correlate related errors.",
                      "example": {}
                    }
                  },
                  "xml": {
                    "name": "Error500ForDisputes"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```