Submit one or more pieces of evidence to a dispute using multipart/form-data. Each form field name is the evidence category slug (from category.allowed_evidence[].name). For FILE evidence, the field value is the file binary. The server validates its detected MIME type against the configured allowlist, which defaults to image/png, image/jpeg, and application/pdf. For TEXT evidence, the field value is the text string. Maximum 10 evidence items per request. One submission per evidence category slug. Evidence can only be submitted while the dispute is in ACTION_REQUIRED status. Submitting evidence does not automatically trigger a challenge — call POST /v1/disputes//challenge to finalize and forward your case.
Unique identifier of the dispute to submit evidence for. The dispute must be in ACTION_REQUIRED status.
Single file upload
{
"ITEMIZED_RECEIPTS": "(binary file content)"
}Single text evidence
{
"OFFICIAL_MERCHANT_STATEMENT": "The customer completed the transaction at our store."
}Multiple evidence items in one request
{
"ITEMIZED_RECEIPTS": "(binary file content)",
"OFFICIAL_MERCHANT_STATEMENT": "Customer was present at the store."
}Each field name is an evidence category slug. File fields contain the binary file. Text fields contain the text content string.
Evidence submission result.
Response for multipart evidence submission.
The dispute ID for which evidence was submitted.
Evidence items that were successfully processed.
One evidence item that was processed successfully.
Xendit-generated identifier for this evidence item.
The evidence category this item was filed under.
Original filename. Only present for FILE evidence.
Detected MIME type. Only present for FILE evidence.
FILE or TEXT.
MD5 integrity hash prefixed with md5:. Only present for FILE evidence.
Evidence items that could not be processed. Only these items need to be resubmitted after correcting the issue.
One evidence item that could not be processed.
The evidence category slug that was submitted.
The filename of the file that failed.
Human-readable explanation of why this item failed.
Machine-readable failure code.
Human-readable summary of the overall submission result.
Evidence submission invalid.
{
"error_code": "INVALID_REQUEST",
"message": "Invalid multipart request."
}{
"error_code": "EVIDENCE_CATEGORY_NOT_ALLOWED",
"message": "Evidence category 'invalid_slug' is not allowed for this dispute's category."
}{
"error_code": "CATEGORY_LIMIT_REACHED",
"message": "Per-category evidence limit reached for category 'proof_of_delivery'."
}{
"error_code": "UNSUPPORTED_EVIDENCE_TYPE",
"message": "File type is not supported."
}Dispute not found.
{
"error_code": "DISPUTE_NOT_FOUND",
"message": "The specified dispute was not found."
}Evidence submission not allowed in the current dispute state.
{
"error_code": "ILLEGAL_STATE",
"message": "The requested action is not allowed in the current dispute state."
}{
"error_code": "ILLEGAL_STATE",
"message": "This simulated dispute is expected to exceed deadline without evidence submission."
}