Skip to main content
GET
/
v1
/
disputes
/
{disputeId}
curl https://api.vouchmark.com/v1/disputes/dsp_aBcD... \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "data": {
    "disputeId": "dsp_aBcD...",
    "vendorId": "cmp_aBcD...",
    "customerId": "usr_aBcD...",
    "eventId": "evt_xYz...",
    "description": "This sanctions match is a false positive. The listed entity has a different registration number.",
    "documents": [
      {
        "url": "https://res.cloudinary.com/.../evidence.pdf",
        "publicId": "vouchmark-disputes/abc123",
        "filename": "evidence.pdf",
        "mimeType": "application/pdf",
        "uploadedAt": "2026-05-16T10:00:00Z"
      }
    ],
    "status": "upheld",
    "reviewNote": "Confirmed: different entity with a similar name. Event voided.",
    "reviewedBy": "adm_aBcD...",
    "reviewedAt": "2026-05-17T14:30:00Z",
    "scoreDeltaRestored": "5.00",
    "eventVoidedAt": "2026-05-17T14:30:00Z",
    "createdAt": "2026-05-16T10:00:00Z",
    "updatedAt": "2026-05-17T14:30:00Z"
  }
}
Returns the full dispute record, including resolution details once it has been reviewed. Ownership is enforced — you can only read disputes you filed.

​
Path parameters

​
disputeId
string
required
The dispute ID (starts with dsp_).
curl https://api.vouchmark.com/v1/disputes/dsp_aBcD... \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "data": {
    "disputeId": "dsp_aBcD...",
    "vendorId": "cmp_aBcD...",
    "customerId": "usr_aBcD...",
    "eventId": "evt_xYz...",
    "description": "This sanctions match is a false positive. The listed entity has a different registration number.",
    "documents": [
      {
        "url": "https://res.cloudinary.com/.../evidence.pdf",
        "publicId": "vouchmark-disputes/abc123",
        "filename": "evidence.pdf",
        "mimeType": "application/pdf",
        "uploadedAt": "2026-05-16T10:00:00Z"
      }
    ],
    "status": "upheld",
    "reviewNote": "Confirmed: different entity with a similar name. Event voided.",
    "reviewedBy": "adm_aBcD...",
    "reviewedAt": "2026-05-17T14:30:00Z",
    "scoreDeltaRestored": "5.00",
    "eventVoidedAt": "2026-05-17T14:30:00Z",
    "createdAt": "2026-05-16T10:00:00Z",
    "updatedAt": "2026-05-17T14:30:00Z"
  }
}
Status is one of pending, under_review, upheld, or rejected. While a dispute is unresolved, reviewNote, reviewedBy, reviewedAt, scoreDeltaRestored, and eventVoidedAt are null. scoreDeltaRestored is returned as a decimal string and is only set when an upheld dispute restored score points.