Retrieve dispute BETA
GET
/v2/disputes/{dispute_id}
Returns details about a specific dispute.
Permissions
PAYMENTS_READ
Try in API Explorer
| Name | Description |
|---|---|
dispute_
Required
|
The ID of the dispute you want more details about. |
Response Fields
| Name | Description |
|---|---|
errors
|
Information about errors encountered during the request. |
dispute
|
Details about the requested |
Examples
GET
/v2/disputes/{dispute_id}
cURL
- cURL
- Ruby
- Python
- C#
- Java
- PHP
- Node.js
curl https://connect.squareup.com/v2/disputes/XDgyFu7yo1E2S5lQGGpYn \
-H 'Square-Version: 2020-12-16' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json'
Response JSON
{
"dispute": {
"dispute_id": "XDgyFu7yo1E2S5lQGGpYn",
"amount_money": {
"amount": 2000,
"currency": "USD"
},
"reason": "NO_KNOWLEDGE",
"state": "LOST",
"due_at": "2018-11-01T00:00:00.000Z",
"disputed_payments": [
{
"payment_id": "6Ee10wvqhfipStz297mtUhBXvaB"
}
],
"card_brand": "visa",
"created_at": "2018-10-18T15:59:13.613Z",
"updated_at": "2018-10-18T15:59:13.613Z",
"brand_dispute_id": "100000282394"
}
}