API reference Merchants

A merchant's disputes and their verdicts

GET/v1/merchants/{merchantId}/disputes

The latest 500 PayPal disputes over the merchant's Keelson purchases, newest first.

Path parameters

merchantIdstringRequired

Responses

200The disputes
401No session
403The session is not this merchant's

200 response

disputesarray of objectRequired

curl -X GET https://api.keelson.finance/v1/merchants/{merchantId}/disputes

const res = await fetch("https://api.keelson.finance/v1/merchants/{merchantId}/disputes", {
  method: "GET",
});
const data = await res.json();

Response · shape from the schema

{
  "disputes": [
    {
      "dispute_id": "string",
      "purchase_id": "string",
      "state": "OPEN",
      "reason": "string",
      "amount_minor": "string",
      "currency": "string",
      "agent_id": "string",
      "received_at": "2026-11-11T00:00:00.000Z",
      "attributed_at": "2026-11-11T00:00:00.000Z",
      "elapsed_ms": 0,
      "liable": "operator",
      "rule": "string",
      "rail": "pyusd",
      "outcome": "paid",
      "paid_by": "chain",
      "ready_at": "2026-11-11T00:00:00.000Z",
      "settled_at": "2026-11-11T00:00:00.000Z",
      "explorer_url": "string",
      "has_alibi": true,
      "amber": {
        "commitment": "string",
        "attested": {},
        "conviction": {}
      }
    }
  ]
}