Submit dispute

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

POST

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)

string

required

The vendor the disputed event belongs to.

string

required

The monitoring event ID being disputed.

string

required

Explanation of why this event is incorrect or should be dismissed.

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.

Overview

Auth

Companies

Verifications

Onboarding (KYB)

Widget Embed (Runtime)

Trust Badge

Monitoring

Investigations

Disputes

Vouch AI

Compliance

Wallet & Billing

Developers

Body (multipart/form-data)

​Body (multipart/form-data)

Body (multipart/form-data)