---
title: "List disputes"
method: GET
path: "/disputes"
tags: ["Disputes"]
---

# List disputes

`GET /disputes`

Retrieve a paginated list of disputes with optional filters. By default, returns disputes not in final status or disputes that reached final status within the last 30 days.

## Query parameters

- `page` integer — The page number to retrieve in a paginated response. Used in combination with **limit** to specify the starting point for a subset of records. (default: 1, min: 1)
- `limit` integer — A limit on the number of objects to be returned. (default: 50, max: 100)
- `status` string — Filter by status (comma-separated values)
- `cardId` string — Filter by card ID
- `transactionId` string — Filter by transaction ID
- `fromDate` string, date-time — The start date for filtering the records, formatted as **YYYY-MM-DD**. Only records from this date onwards will be retrieved.
- `toDate` string, date-time — The end date for filtering the records, formatted as **YYYY-MM-DD**. Only records up to this date will be retrieved.

## Headers

- `Accept-Version` string, required — Specifies the API version to use for this request.

## Response `200`

Return disputes list

- object
  - `items` object[], required — Array of disputes
    - `id` string, uuid, required — The unique identifier of the dispute
    - `transactionId` string, required — The transaction ID
    - `disputeAmount` number, float, required — The disputed amount
    - `disputeCurrency` '344' | '840', required — The ISO 4217 numeric currency code
    - `disputeReason` string, required — The dispute reason
    - `status` 'PENDING' | 'RECEIVED' | 'REVIEWING' | 'SUBMITTED' | 'REQUIRE_ACTION' | 'WON' | 'REFUNDED' | 'LOST' | 'DECLINED' | 'CANCELED', required — Current status of the dispute
    - `cardId` string, required — The card ID associated with the dispute
    - `cardholderName` string, required — The cardholder full name
    - `cardholderEmail` string, email, required — The cardholder email
    - `contactEmail` string, email, required — Email address to be informed of the dispute outcome
    - `createdAt` string, date-time, required — Date the dispute was created
    - `updatedAt` string, date-time, required — Date the dispute was last updated
  - `meta` object, required — Pagination metadata
    - `itemCount` integer, required — The number of items returned on the current page
    - `totalItems` integer, required — The total number of items across all pages
    - `itemsPerPage` integer, required — The maximum number of items that can be returned per page
    - `totalPages` integer, required — The total number of pages available based on the itemsPerPage and totalItems
    - `currentPage` integer, required — The current page number in the paginated response

---

[API](https://skmtc.net/reap-global/apis/reap-api.md) · [All operations](https://skmtc.net/reap-global/apis/reap-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reap-global/reap-api/revisions/525072733e02/schema)