Retrieve full details of a single dispute, including category, allowed evidence types, and submitted evidences. Use include_timeline=true to also receive the audit trail of state transitions.
Unique identifier of the dispute. Returned in the id field from GET /disputes or in webhook payloads.
If true, embeds timeline events inside the dispute response.
Detailed information about the dispute.
Xendit-generated unique dispute identifier.
Timestamp when the dispute was created, in ISO 8601 format.
Timestamp of the last status change, in ISO 8601 format.
Payment channel through which the original transaction was made.
Card network associated with the dispute. Only present when channel_code is CARDS.
Current lifecycle state.
Reason for the dispute outcome.
Currency of the disputed amount, in ISO-4217 format.
The amount when the dispute was first raised.
The final resolved amount. May differ from initial for partial disputes. Null while unresolved.
Optional guidance message from Xendit explaining the dispute reason.
The deadline to take action on this dispute.
Flat list of evidence items (not grouped).
Xendit-generated unique identifier for this evidence item. Use in PATCH and DELETE evidence endpoints.
Evidence type. FILE indicates a file attachment. TEXT indicates inline text content.
Slug of the evidence category this belongs to.
The text content of this evidence item. Only present when type is TEXT.
MIME type of the uploaded file (e.g., application/pdf, image/jpeg). Only present when type is FILE.
Original filename of the uploaded file. Only present when type is FILE.
MD5 hash of the file content, prefixed with md5:. Only present when type is FILE.
Timestamp when this evidence item was submitted, in ISO 8601 format.
Dispute category with the evidence categories allowed for it. Null when the category is not set or could not be resolved.
Slug of the dispute category.
Evidence category slug. Use this exact value as the multipart form field name when calling POST /v1/disputes//evidences.
FILE requires a file upload; TEXT accepts inline text content.
Maximum size for this evidence category. For FILE: maximum file size in bytes. For TEXT: maximum character count.
When true, Xendit recommends submitting this evidence type to strengthen your challenge.
Maximum number of evidence items accepted for this evidence category.
IDs of other disputes linked to the same original transaction.
Xendit payment identifier for the original disputed transaction.
Your reference ID for the original transaction.
Only included when include_timeline=true query param is passed.
Dispute status at the time of this event.
Reason associated with this status transition. Only populated for WON or LOST transitions.
Entity that triggered this event. MERCHANT_VIA_DASHBOARD or MERCHANT_VIA_API for merchant actions. XENDIT for internal system actions.
Internal action name describing what occurred at this step. Provided for informational and debugging purposes.
Optional message associated with this timeline event.
Response deadline applicable at this point in the timeline.
Amount snapshot at this step. Null when the event carries no amount change.
The amount when the dispute was first raised.
The final resolved amount. May differ from initial for partial disputes. Null while unresolved.
Evidence IDs associated with this event.
When this event occurred, in ISO 8601 format.
Access not allowed for this business.
{
"error_code": "RESTRICTED_ACCESS",
"message": "Access to this resource is restricted."
}Dispute not found.
{
"error_code": "DISPUTE_NOT_FOUND",
"message": "The specified dispute was not found."
}