Ask Moov Beta
Generative AI is experimental and can make mistakes.
Guides Use cases API Changelog
  1. API reference
  2. Money movement
  3. Disputes

Retrieve a dispute

Returns a user’s dispute by ID. Read our disputes guide to learn more.

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
/accounts/{accountID}/disputes/{disputeID}
cURL Go 
1
2

curl -X GET "https://api.moov.io/accounts/{accountID}/disputes/{disputeID}" \
  -H "Authorization: Bearer {token}" \

1
2
3
4
5

mc, _ := moov.NewClient()

var disputeID string

mc.GetDispute(ctx, 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.

Response headers

Retry-After

number

Path parameters

accountID

string <uuid> required
ID of the account.

disputeID

string <uuid> required
ID of dispute

Response

application/json
Details about the card dispute.

amount

object
An integer value representing money in a specific 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, for example, $12.04 is 1204 and $0.99 is 99.

createdOn

string<date-time> <=24 characters

disputeID

string<uuid> <=36 characters
UUID

merchantAccountID

string<uuid> <=36 characters
UUID

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
UUID