Skip to content

List disputes

Request

List disputes for a profile with optional filters.

Security
UserToken
Path
profileIdinteger, (int64)required

Your profile ID.

Example:16605997
Query
statusstring

Filter by dispute status.

Enum:"ACTIVE""CLOSED"
Example:status=ACTIVE
transactionIdinteger, (int64)

Filter by card transaction ID.

Example:transactionId=2040
pageSizeinteger, (int32), [ 10 .. 100 ]

The maximum number of disputes to return per page. Between 10 and 100, defaults to 10.

Default:10
Example:pageSize=10
pageNumberinteger, (int32), >= 1

The page number to retrieve. Must be at least 1, defaults to 1.

Default:1
Example:pageNumber=1
Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479
curl -i -X GET \
  'https://api.wise.com/v3/spend/profiles/16605997/disputes?status=ACTIVE&transactionId=2040&pageSize=10&pageNumber=1' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479'

Responses

Paginated list of disputes.

Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"
x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"
Bodyapplication/json
totalCountinteger

Total number of disputes matching the filters.

Example:2
disputesArray of objects
Response
{
  "totalCount": 2,
  "disputes": [
    {
      "id": "51e2dc60-9e4b-4ff5-b917-b90cc5e1ecfb",
      "transactionId": 2040,
      "profileId": 16605997,
      "reason": "NEVER_ARRIVED",
      "status": "ACTIVE",
      "subStatus": "SUBMITTED",
      "statusMessage": "Submitted",
      "createdAt": "2024-03-08T08:30:14.989Z",
      "createdBy": "6097861",
      "lastUpdatedAt": "2024-03-08T08:30:14.989Z",
      "canWithdraw": true
    },
    {
      "id": "9c5ca0cb-00d6-41f7-8214-8cfdb11388a7",
      "transactionId": 3405,
      "profileId": 16605997,
      "reason": "CANCELLED_ORDER",
      "status": "ACTIVE",
      "subStatus": "SUBMITTED",
      "statusMessage": "Submitted",
      "createdAt": "2024-03-27T02:24:16.878Z",
      "createdBy": "6097861",
      "lastUpdatedAt": "2024-03-27T02:24:16.878Z",
      "canWithdraw": true
    }
  ]
}