Dispute Evaluation API.

Send a Stripe dispute packet over HTTP and get the evidence score, CE 3.0 check, and admission scan back as JSON.

POST /api/v1/evaluate
Authentication & Limits
Free tier 10 requests / hr per IP · 128 KB max
No header needed. You get the evidence score, verdict, CE 3.0 check, admission scan, and your top two findings, with X-RateLimit-Remaining headers.
X-License-Key pro.<exp>.<hmac> or Polar key
Send your key to unlock the full checklist, the Stripe enhanced_evidence payload, the bank brief, and the staged Stripe command. Authorization: Bearer works too.
Request Body (application/json)
reason enum
fraudulent, subscription_canceled, product_not_received, product_unacceptable, duplicate, credit_not_processed, unrecognized, or general. We grade a missing or unknown reason as general and add a warning.
card_brand string
Stripe's card brand, such as visa. CE 3.0 runs on Visa disputes only.
network_reason_code string
The network reason code on the dispute, such as 10.4.
amount_usd number
Disputed charge amount in USD (for example 490).
disputed_transaction object
Contains created_at (ISO-8601), customer_purchase_ip, customer_account_id, customer_email_address, customer_device_id, and customer_device_fingerprint.
prior_transactions array<object>
Older payments for the CE 3.0 check: two or more, settled 120 to 365 days before the dispute. Send undisputed: true and refunded: false on each one you have checked.
merchant_rebuttal string
Your draft reply. We scan it for fault admissions and unissued refund promises, and rate how specific it is.
access_activity_log string
Server or session logs that show the customer used the account after checkout.
Response & Status Codes
evidenceScore integer (0 to 100)
Counts the evidence you supplied, from 0 to 100.
verdict string
remove_admission, fix_blockers, review_warnings, or complete.
ce3 object
Contains applicable, network, eligible, matchedElements, and disqualifiers.
semantic object
Contains engine (jev or fallback), fatalAdmissionFlagged, admissionFields, and primaryWeakness.
stripeUpdatePayload object · paid
Stripe evidence, including enhanced_evidence.visa_compelling_evidence_3, with flagged fields left out.
200 · 400 · 413 · 429 HTTP status
200 evaluated, 400 invalid JSON/schema, 413 over 128 KB, 429 free hourly cap reached.