increase-test
GET/card_disputes/{card_dispute_id}

Retrieve a card dispute

Retrieves a card dispute by its identifier. Use this endpoint to review the dispute's status, amount, associated transaction, and any recorded outcome.

1 parameter
card_dispute_idstringrequired
The identifier of the card dispute to retrieve.

3 status codes
200Returns the card dispute, including its identifier, amount, status, network, and associated transaction, account, and card identifiers.
account_idstringrequired
The Account that the Card Dispute is associated with.
amountintegerrequired
The amount of the dispute.
card_idstringrequired
The Card that the Card Dispute is associated with.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card Dispute was created.
disputed_transaction_idstringrequired
The identifier of the Transaction that was disputed.
idstringrequired
The Card Dispute identifier.
idempotency_keystringrequired
The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
lossobjectrequired
If the Card Dispute's status is `lost`, this will contain details of the lost dispute.
networkstringrequired
The network that the Card Dispute is associated with.
Allowed:visapulse
rejectionobjectrequired
If the Card Dispute has been rejected, this will contain details of the rejection.
statusstringrequired
The status of the Card Dispute.
Allowed:user_submission_requiredpending_user_submission_reviewingpending_user_submission_submittingpending_user_withdrawal_submittingpending_responselostwonrejected
typestringrequired
A constant representing the object's type. For this resource it will always be `card_dispute`.
Allowed:card_dispute
user_submission_required_bystringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the user submission is required by. Present only if status is `user_submission_required` and a user submission is required by a certain time. Otherwise, this will be `nil`.
visaobjectrequired
Card Dispute information for card payments processed over Visa's network. This field will be present in the JSON response if and only if `network` is equal to `visa`.
winobjectrequired
If the Card Dispute's status is `won`, this will contain details of the won dispute.
withdrawalobjectrequired
If the Card Dispute has been withdrawn, this will contain details of the withdrawal.
4XXReturned when the request results in a client error.
5XXReturned when the request results in a server error.

Error handling

The card_dispute_id path parameter must identify an existing card dispute.