Skip to main content
GET
List disputes

Authorizations

​
Authorization
string
header
required

API key as Bearer token

Headers

​
Reap-Version
enum<string>
required

API version (YYYY-MM-DD)

Available options:
2025-02-14
Example:

"2025-02-14"

Query Parameters

​
limit
integer
default:20

Maximum number of items to return (1-100, default: 20)

Required range: x <= 100
Examples:

20

50

100

​
cursor
string

Opaque cursor for pagination. Pass nextCursor from previous response to get next page.

​
status
enum<string>[]

Filter by dispute status (comma-separated)

  • PENDING_SIGNATURE: Cardholder must sign a form before the case can progress
  • RECEIVED: Dispute has been recorded and is awaiting review
  • REVIEWING: Dispute is under internal review
  • SUBMITTED: Dispute has been submitted to the card network
  • WON: Dispute resolved in favour of the cardholder
  • LOST: Dispute was filed and Visa ruled for the merchant
  • REFUNDED: Dispute resulted in a refund
  • DECLINED: Reap did not file the case with the network
  • CANCELED: Dispute was canceled
Available options:
PENDING_SIGNATURE,
RECEIVED,
REVIEWING,
SUBMITTED,
WON,
LOST,
REFUNDED,
DECLINED,
CANCELED
​
reason
enum<string>[]

Filter by dispute reason (comma-separated)

  • FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT: A counterfeit copy of the card was used in person
  • FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT: The genuine card was used in person by someone else after being lost or stolen
  • FRAUD_OTHER_CARD_PRESENT: Fraudulent use of the card in person that no other fraud reason covers
  • FRAUD_OTHER_CARD_ABSENT: Fraudulent use of the card details online, by phone, or by mail
  • FRAUD_VISA_MONITORING_PROGRAM: Fraud at a merchant Visa has placed under its fraud monitoring program
  • AUTHORIZATION_CARD_RECOVERY_BULLETIN: The merchant charged the card without authorization while it was blocked
  • AUTHORIZATION_DECLINED: The merchant charged the card after the authorization was declined
  • AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT: The charge was never authorized, or was settled too long after authorization
  • PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE: The transaction was processed as the wrong type, such as a charge instead of a refund
  • PROCESSING_ERROR_INCORRECT_CURRENCY: The transaction was processed in the wrong currency
  • PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER: The transaction was posted to the wrong card number
  • PROCESSING_ERROR_INCORRECT_AMOUNT: The transaction was processed for the wrong amount
  • PROCESSING_ERROR_DUPLICATE_PROCESSING: The same purchase was charged more than once, or was already paid by other means
  • PROCESSING_ERROR_INVALID_DATA: The transaction was processed with invalid or incorrect data
  • CONSUMER_MERCHANDISE_NOT_RECEIVED: The goods or services were never received
  • CONSUMER_CANCELLED_RECURRING: A recurring charge was taken after the cardholder cancelled
  • CONSUMER_NOT_AS_DESCRIBED: The goods or services were not as described, or arrived defective
  • CONSUMER_COUNTERFEIT_MERCHANDISE: The goods received were counterfeit
  • CONSUMER_MISREPRESENTATION: The merchant misrepresented what was being sold
  • CONSUMER_CREDIT_NOT_PROCESSED: The merchant agreed to a refund but never processed it
  • CONSUMER_CANCELLED_MERCHANDISE: The cardholder cancelled the order or returned the goods and was not refunded
  • CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED: A payment pushed to the card was not accepted by the cardholder
  • CONSUMER_NON_RECEIPT_CASH_ATM: An ATM debited the card without dispensing the cash
Available options:
FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT,
FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT,
FRAUD_OTHER_CARD_PRESENT,
FRAUD_OTHER_CARD_ABSENT,
FRAUD_VISA_MONITORING_PROGRAM,
AUTHORIZATION_CARD_RECOVERY_BULLETIN,
AUTHORIZATION_DECLINED,
AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT,
PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE,
PROCESSING_ERROR_INCORRECT_CURRENCY,
PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER,
PROCESSING_ERROR_INCORRECT_AMOUNT,
PROCESSING_ERROR_DUPLICATE_PROCESSING,
PROCESSING_ERROR_INVALID_DATA,
CONSUMER_MERCHANDISE_NOT_RECEIVED,
CONSUMER_CANCELLED_RECURRING,
CONSUMER_NOT_AS_DESCRIBED,
CONSUMER_COUNTERFEIT_MERCHANDISE,
CONSUMER_MISREPRESENTATION,
CONSUMER_CREDIT_NOT_PROCESSED,
CONSUMER_CANCELLED_MERCHANDISE,
CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED,
CONSUMER_NON_RECEIPT_CASH_ATM
​
category
enum<string>[]

Filter by dispute category (comma-separated)

Available options:
FRAUD,
AUTHORIZATION,
PROCESSING_ERROR,
CONSUMER
​
cardId
string<uuid>

Filter by card ID

​
transactionId
string<uuid>

Filter by card transaction ID

​
filedFrom
string<date-time>

Inclusive lower bound on when the dispute was filed. ISO 8601 datetime.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
​
filedTo
string<date-time>

Inclusive upper bound on when the dispute was filed. ISO 8601 datetime.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

Response

200 - application/json

Response for status 200

​
items
object[]
required
​
nextCursor
string | null
required

Cursor for next page, or null if no more items