Skip to main content
GET
Get dispute

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"

Path Parameters

id
string<uuid>
required

Card dispute ID

Response

Card dispute resource

id
string<uuid>
required

Unique dispute identifier

transactionId
string<uuid>
required

The card transaction being disputed

cardId
string<uuid>
required

Card used for the disputed transaction

status
enum<string>
required

Current dispute status

Available options:
RECEIVED,
REVIEWING,
SUBMITTED,
WON,
LOST,
REFUNDED,
DECLINED,
CANCELED
Example:

"RECEIVED"

reason
enum<string>
required

Why the cardholder is disputing the transaction

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
Example:

"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT"

category
enum<string>
required

The grouping the reason belongs to

Available options:
FRAUD,
AUTHORIZATION,
PROCESSING_ERROR,
CONSUMER
Example:

"FRAUD"

amount
object
required

The cardholder amount under dispute, including FX and ATM fees. May be less than the transaction total.

refundedAmount
CardDisputeRefundedAmount · object | null
required

Amount credited to the cardholder when the dispute reaches REFUNDED. Includes the network refund plus a prorated FX markup and ATM variable fee. Does not include the per-withdrawal ATM fixed fee, which stays charged. Null until REFUNDED. May be less than the disputed amount. The same credit is recorded as a DISPUTE_REFUND event on the disputed card transaction and delivered in CARD_TRANSACTION_UPDATED; apply balance changes from that event, not from this field.

cardholder
object
required

Cardholder identity on the case

resolvedAt
string<date-time> | null
required

When the dispute reached a final status, or null while open

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))$
createdAt
string<date-time>
required

ISO 8601 timestamp of creation

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))$
updatedAt
string<date-time>
required

ISO 8601 timestamp of last update

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))$