List dispute evidence
GET
/v2/disputes/{dispute_id}/evidence
Returns a list of evidence associated with a dispute.
Permissions
DISPUTES_READ
Try in API Explorer
| Name | Description |
|---|---|
dispute_
Required
|
The ID of the dispute. |
| 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. |
Response Fields
| Name | Description |
|---|---|
evidence
|
The list of evidence previously uploaded to the specified dispute. |
errors
|
Information about errors encountered during the request. |
cursor
|
The pagination cursor to be used in a subsequent request. If unset, this is the final response. For more information, see Pagination. |
Examples
GET
/v2/disputes/{dispute_id}/evidence
cURL
- cURL
- Ruby
- Python
- C#
- Java
- PHP
- Node.js
curl https://connect.squareup.com/v2/disputes/dispute_id0/evidence \
-H 'Square-Version: 2022-01-20' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json'
Response JSON
{
"evidence": [
{
"id": "TOomLInj6iWmP3N8qfCXrB",
"dispute_id": "bVTprrwk0gygTLZ96VX1oB",
"evidence_text": "1Z8888888888888888",
"evidence_type": "TRACKING_NUMBER",
"uploaded_at": "2018-10-18T16:01:10.000Z"
},
{
"evidence_id": "TOomLInj6iWmP3N8qfCXrB",
"dispute_id": "bVTprrwk0gygTLZ96VX1oB",
"evidence_file": {
"filename": "evidence.tiff",
"filetype": "image/tiff"
},
"evidence_type": "GENERIC_EVIDENCE",
"uploaded_at": "2018-10-18T16:01:10.000Z"
}
],
"cursor": "G1aSTRm48CLjJsg6Sg3hQN1b1OMaoVuG"
}