> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit dispute

> Challenge a monitoring event you believe is a false positive.

Submits a dispute against a specific monitoring event. You can attach up to 5 supporting files (images, PDFs, documents) as evidence. Returns `201` on success.

## Body (multipart/form-data)

<ParamField body="vendorId" type="string" required>
  The vendor the disputed event belongs to.
</ParamField>

<ParamField body="eventId" type="string" required>
  The monitoring event ID being disputed.
</ParamField>

<ParamField body="description" type="string" required>
  Explanation of why this event is incorrect or should be dismissed.
</ParamField>

<ParamField body="files" type="file[]">
  Up to 5 supporting documents (JPEG, PNG, WebP, PDF, DOC, DOCX). Max 10 MB each.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.vouchmark.com/v1/disputes \
    -H "Authorization: Bearer $TOKEN" \
    -F "vendorId=cmp_aBcD..." \
    -F "eventId=evt_xYz..." \
    -F "description=This sanctions match is a false positive. See attached evidence." \
    -F "files=@evidence.pdf" \
    -F "files=@screenshot.png"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "message": "Dispute submitted successfully.",
    "data": {
      "disputeId": "dsp_nEwId...",
      "vendorId": "cmp_aBcD...",
      "customerId": "usr_aBcD...",
      "eventId": "evt_xYz...",
      "description": "This sanctions match is a false positive. See attached evidence.",
      "documents": [
        {
          "url": "https://res.cloudinary.com/.../evidence.pdf",
          "publicId": "vouchmark-disputes/abc123",
          "filename": "evidence.pdf",
          "mimeType": "application/pdf",
          "uploadedAt": "2026-05-18T10:00:00Z"
        },
        {
          "url": "https://res.cloudinary.com/.../screenshot.png",
          "publicId": "vouchmark-disputes/def456",
          "filename": "screenshot.png",
          "mimeType": "image/png",
          "uploadedAt": "2026-05-18T10:00:00Z"
        }
      ],
      "status": "pending",
      "reviewNote": null,
      "reviewedBy": null,
      "reviewedAt": null,
      "scoreDeltaRestored": null,
      "eventVoidedAt": null,
      "createdAt": "2026-05-18T10:00:00Z",
      "updatedAt": "2026-05-18T10:00:00Z"
    }
  }
  ```
</ResponseExample>

A new dispute is created with status `pending`. Only one open dispute (`pending` or `under_review`) may exist per event at a time. Rate limited to 5 submissions per minute.