Verify

Verify any artifact

The generic entry point: the body carries the type (url, payee, or message) alongside value. Behaves exactly like the typed routes.

post/v1/verify

Request

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

Request body

type'url' | 'payee' | 'message' | 'document' required
valuestring required

The artifact to verify.

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.