Verify

Verify a document

Upload a document (PDF, Word/Excel/PowerPoint, HTML, …) as multipart form-data under the field file. Faro converts it to compact Markdown with MarkItDown, extracts and verifies any embedded links, and — when the deterministic tiers are inconclusive — reasons about document fraud (forged letterheads, fake invoices / payment-redirects, bogus KYC, OTP/credential solicitation). Honest note: Faro reads extracted text only — seals, images, and layout are lost, and scanned/image-only files (which need OCR) cannot be read.

post/v1/verify/document

Request

  • Base URL: https://api.farofinance.app
  • URL: https://api.farofinance.app/v1/verify/document
  • Auth: none declared

Response

The verdict for the document.

verdict'green' | 'yellow' | 'red' required
confidencenumber required

Calibrated confidence in the verdict (honest about data completeness).

reasonstring required

One plain-language line explaining the verdict — always present.

recommended_action'allow' | 'warn' | 'block' | 'review' required
explanationstring nullable

Optional longer context (e.g. session repeat-check notes).

request_idstring required

Unique id for this request (also in the X-Request-ID response header).

cachedboolean

True when served from the verdict cache (X-Faro-Cache: hit).

first_seenstring date-time nullable

When Faro first saw this normalized node in the reputation graph.

checked_atstring date-time nullable

When this verdict was computed.

Changes

No recorded changes to this operation across all 1 revision of this API.