Skip to content
Wajub
Loading keys…

Submit evidence

POST /disputes/{id}/submit-evidence: record one piece of evidence against a dispute.

POSThttps://api.wajub.com/disputes/{id}/submit-evidence

Private key required

Dispute endpoints take a private (sk.…) or restricted key, in live and in sandbox. A public key gets a 406.

Each call records one piece of evidence, under its evidence_type. Sending the same type again replaces it. The dispute moves to under_review. Evidence is accepted while the dispute is open or under_review, and refused with a 422 after that.

evidence_typeenumrequired
customer_communication, proof_of_delivery, service_documentation, receipt, product_description, cancellation_policy, refund_policy, duplicate_charge_documentation or other.
evidence_textstringoptional
Up to 2 000 characters.
evidence_filefileoptional
Up to 10 MB: PDF, JPG, PNG, DOC, DOCX or TXT. Send the request as multipart/form-data to attach it.

The response is the dispute, with the evidence under evidence. The file is private: it comes back with url, a signed link valid 30 minutes. Read the dispute again for a fresh one.

POSThttps://api.wajub.com/disputes/{id}/submit-evidence
Request
curl https://api.wajub.com/disputes/dsp_hrgUOE225KMKULRQqYvl/submit-evidence \
  -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \
  -F evidence_type=proof_of_delivery \
  -F "evidence_text=Delivered on 2026-07-16, signed by the customer." \
  -F evidence_file=@delivery-slip.pdf
Response · 200 OK
{
"code": 200,
"status": "OK",
"message": "Evidence submitted successfully",
"dispute": {
"id": "dsp_hrgUOE225KMKULRQqYvl",
"status": "under_review",
"evidence": {
"proof_of_delivery": {
"text": "Delivered on 2026-07-16, signed by the customer.",
"file_path": "8Kq2mX9vL4tRb3nPz7Wd.pdf",
"file_name": "delivery-slip.pdf",
"uploaded_at": "2026-07-16T10:00:00+00:00",
"url": "https://files.example/signed/8Kq2mX9vL4tRb3nPz7Wd.pdf?expires=1800&signature=…"
}
},
"evidence_reaches_provider": false
}
}

Related pages

What did you think of this content?