Disputes made easy.

import { Dispution } from "@dispution/sdk";

const client = new Dispution({
  apiKey: process.env.DISPUTION_API_KEY
});

const verdict = await client.disputes.create({
  occurredAt: "2026-08-16T10:04:00Z",
  claim: {
    summary: "Order arrived at the wrong address."
  },
  evidence: [{
    id: "ev_01", type: "record", content: record
  }]
});

if (verdict.state === "manual_review") {
  queueForReview(verdict.proof.reviewReason);
}

from dispution import Dispution

client = Dispution()

verdict = client.disputes.create(
    occurred_at="2026-08-16T10:04:00Z",
    claim={
        "summary": "Order arrived at the wrong address."
    },
    evidence=[{
        "id": "ev_01",
        "type": "record",
        "content": record
    }]
)

if verdict.state == "manual_review":
    queue_for_review(verdict.proof.review_reason)

# Illustrative, non-routable request shape
curl --request POST 
  "https://api.example.invalid/v1/disputes" 
  --header "Authorization: Bearer $DISPUTION_API_KEY" 
  --header "Idempotency-Key: case_0192" 
  --header "Content-Type: application/json" 
  --data '{
    "occurred_at": "2026-08-16T10:04:00Z",
    "claim": { "summary": "Wrong address." },
    "evidence": [{ "id": "ev_01", "type": "record" }]
  }'

{
  "verdict_id": "vd_01K3M9...",
  "schema_version": "1",
  "state": "manual_review",
  "confidence": 0.84,
  "threshold": 0.90,
  "proof": {
    "review_reason": "material_fact_missing",
    "review_question": "Was safe-place delivery authorised?",
    "evidence_manifest": ["ev_01"]
  }
}