> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get dispute

> Retrieve a single dispute with its current resolution status.

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

<ParamField path="disputeId" type="string" required>
  The dispute ID (starts with `dsp_`).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.vouchmark.com/v1/disputes/dsp_aBcD... \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "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"
    }
  }
  ```
</ResponseExample>

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.