verisoul-lookup

name

verisoul-lookup

description

Look up a user account in Verisoul to check for fraud signals and account authenticity. Use when given an email address (e.g. from a fraud investigation) and you need to verify the account's legitimacy, check risk scores, and analyze email domain and device signals. Returns detailed account information including decision (Real/Fake), risk scores, email analysis, and device/network risk signals. Part of the fraud-bot skill suite.

Verisoul Lookup

Check an account in Verisoul and retrieve fraud risk assessment data.

Schema config

The bq lookup below uses the default logical mapping: project YOUR_GCP_PROJECT and table core_user_facts (dataset prod). Replace them with your physical names from config/schema.json (see SCHEMA.md).

Auth

Requires VERISOUL_API_KEY env var. Uses the Verisoul production API endpoint.

Usage

By User ID (Recommended)

If you have a Warp user ID, use it directly:

curl -s -X GET "https://api.prod.verisoul.ai/account/EXAMPLE_USER_ID" \
  -H "x-api-key: $VERISOUL_API_KEY" \
  -H "Content-Type: application/json"

By Email

If you only have an email, first look up the user ID from BigQuery:

bq query --use_legacy_sql=false "SELECT user_id FROM \`YOUR_GCP_PROJECT.prod.core_user_facts\` WHERE user_email = '[e-mail]' LIMIT 1"

Then use the returned user_id in the curl command above, replacing EXAMPLE_USER_ID with your actual user ID.