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

# Submit additional information

Adds documents or notes to an existing claim when Walmart requests more details.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Claims",
    "version": "1.0",
    "description": "Endpoints for creating and tracking Ship with Walmart (SWW) shipment-protection claims."
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false,
    "explorer-enabled": true
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production URL"
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Sandbox URL"
    }
  ],
  "paths": {
    "/v3/claims/shipment-protection/claim/{claimNumber}": {
      "patch": {
        "tags": [
          "Shipment Protection"
        ],
        "summary": "Submit additional information",
        "description": "Adds documents or notes to an existing claim when Walmart requests more details.",
        "operationId": "submitAdditionalInfo",
        "parameters": [
          {
            "name": "claimNumber",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Exact claim number for filtering (query) or identifying a specific claim (path)."
          },
          {
            "name": "WM_SEC.ACCESS_TOKEN",
            "in": "header",
            "description": "The access token retrieved in the Token API call.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "in": "header",
            "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "WM_QOS.CORRELATION_ID",
            "in": "header",
            "description": "A unique ID which identifies each API call and is used to track and debug issues; use a randomly generated GUID for this ID.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "name": "WM_SVC.NAME",
            "in": "header",
            "description": "Walmart service name—for Marketplace APIs simply use `Walmart Service Name` or the service identifier provided by Walmart.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Service Name"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "files",
                  "documentTypes"
                ],
                "properties": {
                  "files": {
                    "type": "array",
                    "description": "One or more additional supporting files.",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    }
                  },
                  "documentTypes": {
                    "type": "array",
                    "description": "Mapping for each uploaded file.",
                    "items": {
                      "type": "object",
                      "required": [
                        "fileName",
                        "type"
                      ],
                      "properties": {
                        "fileName": {
                          "type": "string",
                          "description": "Original file name for the uploaded document."
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "PROOF_OF_DAMAGED_ITEM",
                            "INVOICE",
                            "OTHER",
                            "PPOD"
                          ],
                          "description": "Document category; one of PROOF_OF_DAMAGED_ITEM, INVOICE, OTHER, PPOD."
                        }
                      },
                      "description": "Object describing a single uploaded document."
                    }
                  },
                  "notes": {
                    "type": "string",
                    "description": "Additional information requested by Walmart"
                  }
                },
                "example": {
                  "files": [
                    "item_damage.jpg"
                  ],
                  "documentTypes": [
                    {
                      "fileName": "item_damage.jpg",
                      "type": "PROOF_OF_DAMAGED_ITEM"
                    }
                  ],
                  "notes": "Here is the picture you requested."
                }
              },
              "encoding": {
                "files": {
                  "contentType": "application/octet-stream"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Additional information submitted successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "data": {
                    "message": "Claim documents uploaded successfully",
                    "documents": [
                      {
                        "id": "8958787967C00000D46C3AC4",
                        "fileName": "5bdf8b64-78b4-4088-8029-0c56d1432973",
                        "fileType": "jpeg",
                        "documentType": "OTHER"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "info": {
                            "type": "string"
                          },
                          "code": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "severity": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "errors": [
                    {
                      "info": "info message",
                      "code": "error code",
                      "description": "detailedMessage",
                      "severity": "ERROR",
                      "category": "DATA etc"
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "info": {
                            "type": "string"
                          },
                          "code": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "severity": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "errors": [
                    {
                      "info": "info message",
                      "code": "error code",
                      "description": "detailedMessage",
                      "severity": "ERROR",
                      "category": "DATA etc"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "info": {
                            "type": "string"
                          },
                          "code": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "severity": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "errors": [
                    {
                      "info": "info message",
                      "code": "error code",
                      "description": "detailedMessage",
                      "severity": "ERROR",
                      "category": "DATA etc"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}
```