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"
}
}
Disputes
Submit dispute
Challenge a monitoring event you believe is a false positive.
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
A new dispute is created with status
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"
}
}
pending. Only one open dispute (pending or under_review) may exist per event at a time. Rate limited to 5 submissions per minute.