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.