Disputes API

You are viewing an old version of the API

2021-02-26

Version 2021-02-26

• All Versions

Disputes API

Create dispute evidence file BETA

Path Parameters

Example code

Name	Description
dispute_id string Required	The ID of the dispute you want to upload evidence for.

Request Body

Name	Description
idempotency_key string Required	The Unique ID. For more information, see Idempotency. Max Length 45 Min Length 1
evidence_type string	The type of evidence you are uploading. Show Values
content_type string	The MIME type of the uploaded file. The type can be image/heic, image/heif, image/jpeg, application/pdf, image/png, or image/tiff. Max Length 40 Min Length 1

Response Fields

Name	Description
errors Error [ ]	Any errors that occurred during the request. Show Attributes
evidence DisputeEvidence	The metadata of the newly uploaded dispute evidence. Show Attributes

curl https://connect.squareup.com/v2/disputes/bVTprrwk0gygTLZ96VX1oB/evidence_file \
  -X POST \
  -H 'Square-Version: 2021-02-26' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Accept: application/json' \
  -F 'file=@/local/path/to/file.jpg' \
  -F 'request={}'

{
  "evidence": {
    "evidence_id": "TOomLInj6iWmP3N8qfCXrB",
    "dispute_id": "bVTprrwk0gygTLZ96VX1oB",
    "evidence_file": {
      "filename": "evidence.tiff",
      "filetype": "image/tiff"
    },
    "uploaded_at": "2018-10-18T16:01:10.000Z"
  }
}