• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

You are viewing an old version of the API
Retrieve dispute

GET /v2/disputes/{dispute_id}

Returns details about a specific dispute.

Permissions
DISPUTES_READ
 Try in API Explorer

Path Parameters

Example code
Name Description
dispute_id
string
Required

The ID of the dispute you want more details about.

Response Fields
Name Description
errors
Error [ ]

Information about errors encountered during the request.
dispute
Dispute

Details about the requested Dispute.

Examples

You are viewing an old version of the API
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: 2022-05-12' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'
Response JSON 
{
  "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"
  }
}