List disputes
Returns a list of disputes associated with a particular account.
Name | Description |
---|---|
cursor
|
A pagination cursor returned by a previous call to this endpoint. Provide this cursor to retrieve the next set of results for the original query. For more information, see Pagination. |
states
|
The dispute states to filter the result.
If not specified, the endpoint returns all open disputes (the dispute status is not |
location_
|
The ID of the location for which to return a list of disputes. If not specified, the endpoint returns
all open disputes (the dispute status is not |
Response Fields
Name | Description |
---|---|
errors
|
Information about errors encountered during the request. |
disputes
|
The list of disputes. |
cursor
|
The pagination cursor to be used in a subsequent request. If unset, this is the final response. For more information, see Pagination. |
Examples
- cURL
- Ruby
- Python
- C#
- Java
- PHP
- Node.js
curl https://connect.squareup.com/v2/disputes \
-H 'Square-Version: 2022-05-12' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json'
{
"disputes": [
{
"id": "OnY1AZwhSi775rbNIK4gv",
"amount_money": {
"amount": 1000,
"currency": "USD"
},
"reason": "NO_KNOWLEDGE",
"state": "EVIDENCE_REQUIRED",
"due_at": "2018-10-11T00:00:00.000Z",
"disputed_payments": [
{
"payment_id": "APgIq6RX2jM6DKDhMHiC6QEkuaB"
}
],
"card_brand": "VISA",
"created_at": "2018-10-12T02:20:25.577Z",
"updated_at": "2018-10-12T02:20:25.577Z",
"brand_dispute_id": "100000809947"
}
],
"cursor": "G1aSTRm48CLjJsg6Sg3hQN1b1OMaoVuG"
}