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

Link to section

Path parameters

Example code

Link to section

dispute_id

string

Required

The ID of the dispute.

Link to section

Query parameters

Link to section

cursor

string

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.

Link to section

Response fields

Link to section

evidence

The list of evidence previously uploaded to the specified dispute.

Link to section

errors

Information about errors encountered during the request.

Link to section

cursor

string

The pagination cursor to be used in a subsequent request. If unset, this is the final response. For more information, see Pagination.

Link to section

Examples

GET /v2/disputes/{dispute_id}/evidence

curl https://connect.squareup.com/v2/disputes/bVTprrwk0gygTLZ96VX1oB/evidence \
  -H 'Square-Version: 2024-04-17' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Response JSON

{
  "evidence": [
    {
      "dispute_id": "bVTprrwk0gygTLZ96VX1oB",
      "evidence_file": {
        "filename": "customer-interaction",
        "filetype": "JPG"
      },
      "uploaded_at": "2022-05-10T15:57:13.802Z",
      "evidence_type": "CARDHOLDER_COMMUNICATION",
      "id": "CpfnkwGselCwS8QFvxN6"
    },
    {
      "dispute_id": "bVTprrwk0gygTLZ96VX1oB",
      "evidence_file": {
        "filename": "",
        "filetype": ""
      },
      "uploaded_at": "2022-05-18T16:01:10.000Z",
      "evidence_type": "REBUTTAL_EXPLANATION",
      "id": "TOomLInj6iWmP3N8qfCXrB"
    }
  ]
}