Sample - Stripe API
GET/v1/disputes/{dispute}

Retrieve a dispute

Retrieves a specific dispute by its identifier. Use expand to request selected fields in expanded form when retrieving the dispute details.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
disputestringrequired
The identifier of the dispute to retrieve, limited to 5,000 characters.
expandarray<string>optional
Fields to expand in the response; each value is a string of no more than 5,000 characters.

2 status codes
200Returns the dispute object with its disputed amount, charge and PaymentIntent references, currency, evidence, status, refundability, balance transactions, and payment method details.
amountintegerrequired
Disputed amount. Usually the amount of the charge, but it can differ (usually because of currency fluctuation or because only part of the order is disputed).
balance_transactionsarray<BalanceTransaction>required
List of zero, one, or two balance transactions that show funds withdrawn and reinstated to your Stripe account as a result of this dispute.
chargestringrequired
ID of the charge that's disputed.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
currencystringrequired
Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
enhanced_eligibility_typesarray<string>required
List of eligibility types that are included in `enhanced_evidence`.
evidenceobjectrequired
evidence_detailsobjectrequired
idstringrequired
Unique identifier for the object.
is_charge_refundablebooleanrequired
If true, it's still possible to refund the disputed payment. After the payment has been fully refunded, no further funds are withdrawn from your Stripe account as a result of this dispute.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
metadataobjectrequired
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:dispute
payment_intentstringoptional
ID of the PaymentIntent that's disputed.
payment_method_detailsobjectoptional
reasonstringrequired
Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `noncompliant`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://docs.stripe.com/disputes/categories).
statusstringrequired
The current status of a dispute. Possible values include:`warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `won`, `lost`, or `prevented`.
Allowed:lostneeds_responsepreventedunder_reviewwarning_closedwarning_needs_responsewarning_under_reviewwon
defaultError response.
errorobjectrequired

Error handling

dispute must identify the dispute to retrieve and may contain no more than 5,000 characters. Each expand entry must be a string of no more than 5,000 characters.