Returns a collection of Dispute response objects.


Managing disputes via the API is only available to merchants who can access disputes in the Braintree Control Panel.

For operators available on search fields, see the search fields page.

Node.js (search) {"dispute_id");
}, function (err, response) {
  response.forEach(function (dispute) {
amountDisputed range

The decimal value representing the disputed amount.

amountWon range

The decimal value representing the reserved amount.

caseNumber text

The case number of the dispute.

customerId text

The unique customer identifier associated with the disputed transaction.

disbursementDate range

The disbursement date of the dispute history event.

effectiveDate range

The effective date of the dispute history event.

id text

The unique dispute identifier.

kind multiple

The kind of dispute.

merchantAccountId multiple

The ID of the merchant account this dispute is for.

reason multiple

The reason for the dispute. See reasons on the dispute response object for possible values.

reasonCode multiple

The raw reason code provided by the processor (e.g. 83).

receivedDate range

The date the dispute was received by the merchant.

referenceNumber text

The reference number of the dispute.

replyByDate range

The merchant Reply By date that is referenced in the gateway.

status multiple

The status of the dispute. Possible values:

  • Accepted
  • Disputed
  • Expired
  • Open
  • Lost
  • Won

See dispute statuses for more details.

transactionId text

The unique identifier for the disputed transaction.

transactionSource multiple

How a transaction was created. Possible values:

  • Api
  • ControlPanel
  • Recurring
  • OAuth application client ID of the transaction facilitator


Multiple kinds

This example shows searches on the kind parameter:

Node.js (search) {
}, function (err, response) {

Amount disputed range

This example shows searches on the amountDisputed parameter:

Node.js (search) {
  search.amountDisputed().between("100.00", "200.00");
}, function (err, response) {