Skip to main content
POST
/
v1
/
disputes
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"

{
  "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"
  }
}
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)

​
vendorId
string
required
The vendor the disputed event belongs to.
​
eventId
string
required
The monitoring event ID being disputed.
​
description
string
required
Explanation of why this event is incorrect or should be dismissed.
​
files
file[]
Up to 5 supporting documents (JPEG, PNG, WebP, PDF, DOC, DOCX). Max 10 MB each.
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"

{
  "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"
  }
}
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.