Verify

Verify a URL

Check a link before visiting, sharing, or acting on it. Runs Google Safe Browsing and a domain-age (RDAP) check, and — only when those are inconclusive — an LLM that reasons about brand impersonation and deceptive intent.

post/v1/verify/url

Request

  • Base URL: https://api.farofinance.app
  • URL: https://api.farofinance.app/v1/verify/url
  • Auth: HTTP bearer

Request body

valuestring required

The artifact to verify (a URL, payee, or message string).

regionstring nullable

Optional ISO 3166-1 alpha-2 region hint (e.g. IN, US) used only to interpret a bare phone number that has no country code. Labelling context only — it never changes the reputation node, sanctions, or the verdict. A number written in full +<country code> form is identified regardless.

Example request

{
  "region": "IN"
}

Response

The verdict for the artifact.

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.