---
title: "Create a dispute report"
method: POST
path: "/v1/dispute-reports"
tags: ["Dispute Reports"]
---

# Create a dispute report

`POST /v1/dispute-reports`

Triggers generation of a dispute report for the given merchant over the specified date range. The date range must be within the last 90 days and the end date must be before now.

## Headers

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

## Request body

- CreateReportRequest — Request body for creating a dispute report
  - `startDate` string, date-time, required — Start of the reporting window. Must be within the last 90 days.
  - `endDate` string, date-time, required — End of the reporting window.

## Response `200`

Report created successfully

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