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

Retrieve an Issuing dispute

Retrieves a single Issuing dispute by its identifier. Use expand when you need selected fields expanded in the response rather than returned as references. The dispute value must be no longer than 5000 characters.

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

2 parameters
disputestringrequired
The unique identifier of the Issuing dispute. Maximum 5000 characters.
expandarray<string>optional
Fields to expand in the response. Each field name may be up to 5000 characters.

2 status codes
200Returns the Issuing dispute object, including its amount, currency, evidence, status, transaction, and associated balance transactions.
amountintegerrequired
Disputed amount in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation).
balance_transactionsarray<BalanceTransaction>optional
List of balance transactions associated with the dispute.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
currencystringrequired
The currency the `transaction` was made in.
evidenceobjectrequired
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
loss_reasonstringoptional
The enum that describes the dispute loss outcome. If the dispute is not lost, this field will be absent. New enum values may be added in the future, so be sure to handle unknown values.
Allowed:cardholder_authentication_issuer_liabilityeci5_token_transaction_with_tavvexcess_disputes_in_timeframehas_not_met_the_minimum_dispute_amount_requirementsinvalid_duplicate_disputeinvalid_incorrect_amount_disputeinvalid_no_authorizationinvalid_use_of_disputesmerchandise_delivered_or_shippedmerchandise_or_service_as_describednot_cancelledother
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:issuing.dispute
statusstringrequired
Current status of the dispute.
Allowed:expiredlostsubmittedunsubmittedwon
transactionstringrequired
The transaction being disputed.
treasuryobjectoptional
[Treasury](https://docs.stripe.com/api/treasury) details related to this dispute if it was created on a [FinancialAccount](https://docs.stripe.com/api/treasury/financial_accounts)
defaultReturned when the request cannot be processed; the response contains an `error` object with a reason and error type.
errorobjectrequired

Error handling

dispute must identify the Issuing dispute to retrieve and must not exceed 5000 characters. Use expand to request expanded fields, with each field name limited to 5000 characters.