Sign in

v1

latestOpenAPI 3.1.02026-07-2663312285.4 KB
Dispute Reports

Get a dispute report by ID

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

get/v1/dispute-reports/{reportId}

Path parameters

reportIdstring required

The report ID returned when the report was created.

Headers

Merchant-Idstring required

The merchant identifier.

Request-Referencestring

Optional Reference for the request. This is used to identify the request in debugging.

Response

Report found

idstring

Unique report identifier.

startDatestring date-time

Start of the reporting window.

endDatestring date-time

End of the reporting window.

status'PENDING' | 'PROCESSED' | 'FAILED' | 'EXPIRED'

Current processing status of the report.

downloadUrlstring

Pre-signed URL to download the generated report file. Present only when status is PROCESSED.

createdAtstring date-time

Timestamp when the report was created.

updatedAtstring date-time

Timestamp when the report was updated.

Example response

{
  "id": "report_a1b2c3d4e5f67890abcde",
  "startDate": "2026-06-17T00:00:00Z",
  "endDate": "2026-07-17T11:58:00Z",
  "status": "PENDING",
  "downloadUrl": "https://example.com/reports/report_a1b2c3d4e5f67890abcde.csv?expires=3600",
  "createdAt": "2026-07-17T12:00:00Z",
  "updatedAt": "2026-07-17T12:00:00Z"
}