For archived content, access the previous documentation here or the previous API reference here.

Finalize and submit evidence

  • Updated on Sep 10, 2026
  • Published on Sep 4, 2026
Prev Next
Post
/v1/disputes/{dispute_id}/challenge

Finalize and submit all uploaded evidence to contest the dispute. Once submitted, the dispute moves to UNDER_REVIEW status and evidence can no longer be added, modified, or deleted. The outcome (WON or LOST) is determined asynchronously and delivered via webhook. The dispute must be in ACTION_REQUIRED status and must have at least one evidence item.

Security
HTTP
Type basic
Path parameters
dispute_id
stringRequired

Unique identifier of the dispute.

Responses
202

Challenge accepted. The dispute will be processed asynchronously.

object

Response body for public dispute actions (challenge, accept).

dispute_id
string

ID of the dispute the action was applied to.

Examplemi-dspt-48e96517-9889-4e29-a93e-d1ffae1fa366
message
string

Human-readable summary of the applied action.

ExampleAccept acknowledged. The dispute will be processed asynchronously.
400

Action not allowed in current state.

illegal_state
{
  "error_code": "ILLEGAL_STATE",
  "message": "The requested action is not allowed in the current dispute state."
}
no_evidence
{
  "error_code": "INVALID_REQUEST",
  "message": "No evidence items provided."
}
object
error_code
string
ExampleILLEGAL_STATE
message
string
ExampleThe requested action is not allowed in the current dispute state.
404

Dispute not found.

{
  "error_code": "DISPUTE_NOT_FOUND",
  "message": "The specified dispute was not found."
}
object
error_code
string
ExampleILLEGAL_STATE
message
string
ExampleThe requested action is not allowed in the current dispute state.
409

Challenge not allowed for this dispute.

{
  "error_code": "ILLEGAL_STATE",
  "message": "This simulated dispute is expected to exceed deadline without evidence submission."
}
object
error_code
string
ExampleILLEGAL_STATE
message
string
ExampleThe requested action is not allowed in the current dispute state.
422

This dispute uses an unsupported workflow version.

{
  "error_code": "ILLEGAL_STATE",
  "message": "This dispute uses a deprecated FSM version that is no longer supported."
}
object
error_code
string
ExampleILLEGAL_STATE
message
string
ExampleThe requested action is not allowed in the current dispute state.