---
title: "Get a dispute report by ID"
method: GET
path: "/v1/dispute-reports/{reportId}"
tags: ["Dispute Reports"]
---

# Get a dispute report by ID

`GET /v1/dispute-reports/{reportId}`

Returns the report metadata and, when processing is complete, a pre-signed download URL.

## Path parameters

- `reportId` string, required

## Headers

- `Merchant-Id` string, required
- `Request-Reference` string

## Response `200`

Report found

- ReportResponse — Dispute report details
  - `id` string — Unique report identifier.
  - `startDate` string, date-time — Start of the reporting window.
  - `endDate` string, date-time — End of the reporting window.
  - `status` 'PENDING' | 'PROCESSED' | 'FAILED' | 'EXPIRED' — Current processing status of the report.
  - `downloadUrl` string — Pre-signed URL to download the generated report file. Present only when status is PROCESSED.
  - `createdAt` string, date-time — Timestamp when the report was created.
  - `updatedAt` string, date-time — Timestamp when the report was updated.

## Other responses

- `400` — Bad Request
- `401` — Unauthorised
- `404` — Not found
- `409` — Duplicate request received with the same idempotency key.
- `500` — Internal Server Error

---

[API](https://skmtc.net/ppro/apis/payment-charges.md) · [All operations](https://skmtc.net/ppro/apis/payment-charges/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ppro/payment-charges/versions/112e8bb4c815/schema)