Create dispute evidence file
POST
/v2/disputes/{dispute_id}/evidence-files
Uploads a file to use as evidence in a dispute challenge.
The endpoint accepts HTTP multipart/form-data file uploads in HEIC, HEIF, JPEG, PDF, PNG, and TIFF formats.
| Name | Description |
|---|---|
dispute_
Required
|
The ID of the dispute you want to upload evidence for. |
| Name | Description |
|---|---|
idempotency_
Required
|
The Unique ID. For more information, see Idempotency. |
evidence_
|
The type of evidence you are uploading. |
content_
|
The MIME type of the uploaded file. The type can be image/heic, image/heif, image/jpeg, application/pdf, image/png, or image/tiff. |
Response Fields
| Name | Description |
|---|---|
errors
|
Any errors that occurred during the request. |
evidence
|
The metadata of the newly uploaded dispute evidence. |
Examples
POST
/v2/disputes/{dispute_id}/evidence-files
cURL
- cURL
- Ruby
- Python
- C#
- Java
- PHP
- Node.js
curl https://connect.squareup.com/v2/disputes/bVTprrwk0gygTLZ96VX1oB/evidence-files \
-X POST \
-H 'Square-Version: 2021-09-15' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Accept: application/json' \
-F 'file=@/local/path/to/file.jpg' \
-F 'request={}'
Response JSON
{
"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"
}
}