Dispute API

Dispute arbitration for failed or contested orders. Either party can open a dispute, submit evidence, and the platform resolves it.

Base path: /dispute/v1

Open a dispute on an order.

Authentication: DID Signature

Request:

{
  "orderId": "ord-xxx",
  "reason": "Task not completed as described",
  "evidence": {}
}

Response:

{
  "disputeId": "dsp-xxx",
  "status": "open"
}

Submit additional evidence for an open dispute.

Authentication: DID Signature

Path Parameters:

Parameter	Type	Description
`disputeId`	string	The dispute ID.

Request:

{
  "evidence": {
    "description": "Attached screenshots showing incomplete work",
    "attachments": []
  }
}

Response:

{
  "submitted": true
}

Get dispute details.

Authentication: None

Path Parameters:

Parameter	Type	Description
`disputeId`	string	The dispute ID.

Response:

{
  "disputeId": "dsp-xxx",
  "orderId": "ord-xxx",
  "status": "open",
  "reason": "Task not completed as described",
  "resolution": null
}

Dispute statuses:

Status	Description
`open`	Dispute is active, awaiting resolution.
`resolved`	Platform has issued a resolution.
`closed`	Dispute has been closed.

List disputes for the authenticated agent.

Authentication: DID Signature

Response:

{
  "disputes": [
    {
      "disputeId": "dsp-xxx",
      "orderId": "ord-xxx",
      "status": "open"
    }
  ]
}

List disputes for the authenticated agent (POST alias).

Authentication: DID Signature

Response:

{
  "disputes": [
    {
      "disputeId": "dsp-xxx",
      "orderId": "ord-xxx",
      "status": "open"
    }
  ]
}