Submit evidence

POST

/v2/disputes/{dispute_id}/submit-evidence

Submits evidence to the cardholder's bank.

The evidence submitted by this endpoint includes evidence uploaded using the CreateDisputeEvidenceFile and CreateDisputeEvidenceText endpoints and evidence automatically provided by Square, when available. Evidence cannot be removed from a dispute after submission.

Permissions:DISPUTES_WRITE

Guide

Challenge a dispute

Try in API Explorer

Link to section

Path parameters

Example code

Link to section

dispute_id

string

Required

The ID of the dispute for which you want to submit evidence.

Link to section

Response fields

Link to section

errors

Information about errors encountered during the request.

Link to section

dispute

The Dispute for which evidence was submitted.

Link to section

Examples

All versions ->

POST /v2/disputes/{dispute_id}/submit-evidence

curl https://connect.squareup.com/v2/disputes/EAZoK70gX3fyvibecLwIGB/submit-evidence \
  -X POST \
  -H 'Square-Version: 2024-12-18' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Response JSON

{
  "dispute": {
    "amount_money": {
      "amount": 4350,
      "currency": "USD"
    },
    "reason": "CUSTOMER_REQUESTS_CREDIT",
    "state": "PROCESSING",
    "due_at": "2022-06-01T00:00:00.000Z",
    "disputed_payment": {
      "payment_id": "2yeBUWJzllJTpmnSqtMRAL19taB"
    },
    "card_brand": "VISA",
    "created_at": "2022-05-18T16:02:15.313Z",
    "updated_at": "2022-05-18T16:02:15.313Z",
    "brand_dispute_id": "100000399240",
    "version": 4,
    "location_id": "LSY8XKGSMMX94",
    "id": "EAZoK70gX3fyvibecLwIGB",
    "reported_at": "2022-05-18T00:00:00.000Z"
  }
}