Skip to main content

SearchRisk

POST 
/risk

Experimental (beta): This endpoint is new and under active development. The risk scoring rules, check definitions, and response shape may change as the feature matures. Monitor the changelog before relying on specific values in production.

Returns a person's fraud risk profile in a single call, combining our proprietary Radar fraud signals with optional partner enrichment data.

Radar is our always-on fraud-signal engine. It screens the person against the Vouchsafe blocklist and network data, and raises the following signals:

  • known_blocklist_match — whether the identity matches any known fraudster records
  • email_linked_to_multiple_identities — whether this email has been seen associated with different identities in the Vouchsafe network
  • email_velocity — whether the submission velocity is within normal bounds
  • face_linked_to_multiple_identities — whether the submitted face has been seen associated with different identities in the Vouchsafe network. Requires face_scan

A Radar signal returns one of three states:

  • PASS — we looked and found nothing unusual.
  • FAIL — we found something worth your attention.
  • NOT_PERFORMED — we could not run this check (e.g. no face_scan provided or a system error occurred).

You can optionally add enrichment checks via enrichments:

  • credit_bureau — credit reference agency data plus public records (requires address)
  • online_footprint — public traces of online activity associated with the email
  • aml — international sanctions, watchlists, and high-risk person lists

Face scan​

The endpoint accepts an optional face_scan — a live selfie or liveness image (JPEG or PNG, max 10 MB). When provided, Radar runs face_linked_to_multiple_identities — checking whether this face has been submitted under different names in the network. Without it, that check returns NOT_PERFORMED.

Address​

When the Credit Bureau enrichment is enabled, a structured address is required. This should be taken from the results returned by the GET /postcode endpoint.

Sandbox​

In sandbox mode, a mock radar_verification_report is returned with state: "PASS" and all checks in state "PASS". No actual fraud-signal processing occurs.

This endpoint supports sandbox mode. See how sandbox mode works.

Request​

Responses​

Risk assessment completed