---
title: "Get disputes"
method: GET
path: "/v1/reporting/disputes"
tags: ["Reporting"]
---

# Get disputes

`GET /v1/reporting/disputes`

## Request

- Base URL: `https://integration.api.scalapay.com`
- URL: `https://integration.api.scalapay.com/v1/reporting/disputes`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/scalapay/apis/scalapay-api/docs/v1/reporting/disputes/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a paginated list of disputes for reporting purposes with filtering options.

## Query parameters

- `startDate` string, date, required
- `endDate` string, date, required
- `disputeStatus` 'open' | 'processing' | 'won' | 'lost' | 'closed'
- `page` integer
- `size` integer

## Response `200`

Disputes retrieved successfully.

- object
  - `items` object[], required
    - `disputeToken` string, required: Unique dispute identifier
    - `orderToken` string, required: Token of the associated order
    - `merchantOrderReference` string, nullable: Merchant's order reference
    - `merchantDisputeReference` string, nullable: Merchant's internal reference
    - `disputeStatus` 'open' | 'processing' | 'won' | 'lost' | 'closed', required: Dispute status
    - `openingReason` 'credit_not_processed' | 'duplicate' | 'fraudulent' | 'general' | 'product_not_received' | 'product_unacceptable' | 'subscription_canceled' | 'unrecognized_payment', required: Reason dispute was opened
    - `resolvingReason` 'customer_canceled' | 'evidence_accepted' | 'evidence_deadline_expired' | 'evidence_rejected' | 'merchant_accepted' | 'resolution_deadline_expired', nullable: How dispute was resolved
    - `amountInCents` integer, required: Disputed amount in cents
    - `currency` string, required: Currency code
    - `liability` 'pending' | 'merchant' | 'scalapay', nullable: Indicates who bears liability for the dispute
    - `createdAt` string, date-time, required: ISO 8601 datetime when dispute was created
    - `expiresAt` string, date-time, required: ISO 8601 datetime when dispute expires
    - `updatedAt` string, date-time, nullable: ISO 8601 datetime of last update
    - `resolvedAt` string, date-time, nullable: ISO 8601 datetime when resolved
  - `total` integer, required: Total number of disputes matching filters
  - `page` integer, required: Current page number (zero-based)
  - `size` integer, required: Number of items per page
  - `hasMore` boolean, required: Whether there are more pages available

## Other responses

- `400`: Bad request. (HTTP 400).
- `401`: Unauthorized
- `500`: Internal server error. (HTTP 500).

## Changes

- **2026-11-03** `175c16830418`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scalapay/apis/scalapay-api/changes/v1/reporting/disputes/get.md)

---

[API](https://skmtc.dev/scalapay/apis/scalapay-api.md) - [All operations](https://skmtc.dev/scalapay/apis/scalapay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalapay/apis/scalapay-api/revisions/175c16830418?raw)