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)
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.