verify-documentlisted

# Document Verification Inspect a document for forensic authenticity signals — not a fraud verdict, but a risk band with the evidence behind it. Uses the Stipple API (free anonymous tier, no signup). ## When to use - Before onboarding a tenant, contractor, or employee from uploaded documents - Before paying an invoice that arrived by email - Before relying on a bank statement, payslip, or certificate in any workflow - Reviewing documents in due diligence, claims processing, or loan applications ## Instructions 1. **Get the document.** URL or local file path (PDF, PNG, JPEG, BMP, TIFF). 2. **Optionally check the cache first.** If the user has the file's SHA-256, check whether it's already been inspected (free): ```bash curl "https://www.stipple.sh/v1/warrants/check?sha256=<hash>" ``` 3. **Run verification.** POST the document: ```bash curl -X POST https://www.stipple.sh/v1/warrants \ -F "file=@payslip.pdf" \ -H "Authorization: Bearer $STIPPLE_API_KEY" ``` Add `?fresh=true` to force re-inspection of a previously cached document. Add `?deep=true` for deep inspection (more thorough, more credits). 4. **Interpret the response.** Two independent axes — read both: | Axis | Question it answers | |---|---| | `risk_band` | Does anything look tampered? (low / medium / high) | | `inspection_quality` | Could the engine actually see enough to judge? (thorough / limited / poor) | A clean phone photo of a real payslip is commonly `lo