POST
/
disputes
/
merchants
/
getall
cURL
curl -X POST "https://dev.api.onekhusa.com/sandbox/v1/disputes/merchants/getall" \
 --header "Authorization: Bearer your-jwt-token" \
 --header "Content-Type: application/json" \
 --header "Accept-Language: en" \
 -d '{
   "merchantAccountNumber": 11223344,
   "pageNumber": 1,
   "numberOfReturnedRows": 10,
   "isIncremental": true,
   "searchBy": "TransactionReferenceNumber",
   "searchText": ""
 }'
[
  {
    "disputeId": 3,
    "amountDisputed": 12500,
    "transactionReferenceNumber": "250828AU2LXJ",
    "reason": "Service not rendered",
    "description": "The receiver did not get the funds despite being successful",
    "dateOpened": "2026-04-01 18:22:51",
    "statusCode": "L",
    "beneficiaryName": "JAMES BANDA"
  },
  {
    "disputeId": 4,
    "amountDisputed": 12500,
    "transactionReferenceNumber": "250828AU2LXJ",
    "reason": "Service not rendered",
    "description": "The receiver did not get the funds despite being successful",
    "dateOpened": "2026-04-01 18:22:51",
    "statusCode": "W",
    "beneficiaryName": "JAMES BANDA"
  }
]

Authorizations

ā€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer Token, Where accessToken is the access token used to authenticate the request.

Headers

ā€‹
Accept-Language
string
default:en

Preferred language for the response

Body

application/json
ā€‹
merchantAccountNumber
integer
required

Merchant account number to retrieve disputes for.

Example:

11223344

ā€‹
pageNumber
integer
required

The page number to retrieve.

Required range: x >= 1
Example:

1

ā€‹
numberOfReturnedRows
integer
required

The number of rows to return per page.

Required range: x >= 1
Example:

10

ā€‹
isIncremental
boolean
default:true

Determines whether records should be fetched incrementally.

Example:

true

ā€‹
searchBy
enum<string>
default:TransactionReferenceNumber

The field used for searching disputes.

Available options:
TransactionReferenceNumber
Example:

"TransactionReferenceNumber"

ā€‹
searchText
string
default:""

Search value for filtering disputes. Leave empty to retrieve all disputes.

Example:

""

Response

Success Response (200)

ā€‹
disputeId
integer

Unique identifier of the dispute.

Example:

3

ā€‹
amountDisputed
number<decimal>

Amount disputed by the merchant or customer.

Example:

12500

ā€‹
transactionReferenceNumber
string

Unique transaction reference number.

Example:

"250828AU2LXJ"

ā€‹
reason
string

Reason for opening the dispute.

Example:

"Service not rendered"

ā€‹
description
string

Detailed description of the dispute.

Example:

"The receiver did not get the funds despite being successful"

ā€‹
dateOpened
string<date-time>

Date and time when the dispute was opened.

Example:

"2026-04-01 18:22:51"

ā€‹
statusCode
string

Current dispute status code R=Review, O=Open, W=Win, L=Lose

Example:

"W"

ā€‹
beneficiaryName
string

Name of the transaction beneficiary.

Example:

"JAMES BANDA"