• 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-09-21' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'
Response JSON 
{
  "dispute": {
    "amount_money": {
      "amount": 2500,
      "currency": "USD"
    },
    "reason": "NO_KNOWLEDGE",
    "state": "ACCEPTED",
    "due_at": "2022-07-13T00:00:00.000Z",
    "disputed_payment": {
      "payment_id": "zhyh1ch64kRBrrlfVhwjCEjZWzNZY"
    },
    "card_brand": "VISA",
    "created_at": "2022-06-29T18:45:22.265Z",
    "updated_at": "2022-07-07T19:14:42.650Z",
    "brand_dispute_id": "100000809947",
    "version": 2,
    "location_id": "L1HN3ZMQK64X9",
    "id": "XDgyFu7yo1E2S5lQGGpYn",
    "reported_at": "2022-06-29T00:00:00.000Z"
  }
}