---
title: "List disputes"
method: GET
path: "/v3/spend/profiles/{profileId}/disputes"
tags: ["disputes"]
---

# List disputes

`GET /v3/spend/profiles/{profileId}/disputes`

List disputes for a profile with optional filters.

## Path parameters

- `profileId` integer, required

## Query parameters

- `status` 'ACTIVE' | 'CLOSED'
- `transactionId` integer
- `pageSize` integer
- `pageNumber` integer

## Headers

- `X-External-Correlation-Id` string, uuid

## Response `200`

Paginated list of disputes.

- object
  - `totalCount` integer — Total number of disputes matching the filters.
  - `disputes` Dispute[]
    - `id` string — Unique identifier of the dispute.
    - `transactionId` integer — Card transaction ID.
    - `profileId` integer — Profile ID.
    - `reason` string — Dispute reason code.
    - `status` 'ACTIVE' | 'CLOSED' — Dispute overall status.
    - `subStatus` 'SUBMITTED' | 'IN_REVIEW' | 'REFUNDED' | 'REJECTED' | 'WITHDRAWN' | 'CONFIRMED' | 'REFUND_IN_PROGRESS' | 'ATTEMPTING_RECOVERY' | 'RECOVERY_UNSUCCESSFUL' — Dispute detailed status.
    - `statusMessage` string — Explanation for `subStatus`.
    - `createdAt` string, date-time — Time when the dispute was created.
    - `createdBy` string — Creator of the dispute. Currently set to the user ID.
    - `lastUpdatedAt` string, date-time — Time when the dispute was last updated.
    - `canWithdraw` boolean — Whether the dispute can be withdrawn.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/versions/4907a1d269ab/schema)