Retrieve a dispute

Returns a user’s dispute by ID.

To use this endpoint from the browser, you’ll need to specify the /accounts/{your-account-id}/transfers.read scope when generating a token.
GET
/disputes/{disputeID}
200 429
Dispute details.
Details about the card dispute.
{
  "amount": {
    "currency": "USD",
    "value": 1204
  },
  "createdOn": "2019-08-24T14:15:22Z",
  "disputeID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "merchantAccountID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "networkReasonCode": "string",
  "networkReasonDescription": "string",
  "phase": "pre-dispute",
  "respondBy": "2019-08-24T14:15:22Z",
  "status": "response-needed",
  "transfer": {
    "transferID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43"
  }
}
Request was refused due to rate limiting.

X-Retry-In

string <duration>
How long (in milliseconds) to wait until able to retry the request.

Path parameters

disputeID

string <uuid> required
ID of dispute

Response

application/json
Details about the card dispute.

amount

object
A representation of money containing an integer value and its currency.
right_key Show child attributes

currency

string <=3 characters Pattern
A 3-letter ISO 4217 currency code.

value

integer<int64>
Quantity in the smallest unit of the specified currency. In USD this is cents, so $12.04 is 1204 and $0.99 would be 99.

createdOn

string<date-time> <=24 characters

disputeID

string<uuid> <=36 characters Pattern
UUID v4

merchantAccountID

string<uuid> <=36 characters Pattern
UUID v4

networkReasonCode

string
Indicates the card network’s category for the dispute. These codes may differ between card brands. You can find more information on the code from the networkReasonDescription field.

networkReasonDescription

string
Provides detail on the card network’s categorization of the dispute.

phase

string<enum>
The phase of a particular dispute.
Possible values: pre-dispute, inquiry, chargeback, unknown

respondBy

string<date-time> <=24 characters

status

string<enum>
The status of a particular dispute. Read our disputes guide to learn what each status means.
Possible values: response-needed, resolved, under-review, closed, accepted, expired, won, lost

transfer

object
Details about the transfer.
right_key Show child attributes

transferID

string<uuid> <=36 characters Pattern
UUID v4