Contact and sanctions screening (not identity verification)
hubvibe_contact_screenScreen a name against sanctions lists, evaluate email deliverability and disposable signals, validate a phone number's numbering plan and inspect IP geography/network. Returns findings, per-check completion, and a screening risk indicator. Never proves document authenticity, ownership or liveness, and is NOT complete KYC or identity verification. Inconclusive/failed checks cannot produce a low-risk result. Input: any of name, email, phone, ip; optional country/birth_year. $0.10 per call. Returns: input{}, risk (low | review | high), verification_status (not_verified), assessment_status (complete | incomplete), check_statuses{}, flags[{code, severity, detail}], checks{sanctions, email, phone, ip}, checks_run[], checks_failed[], notes[], checked_at.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ip | No | The client's IPv4 or IPv6 address. | |
| name | No | Person or company name to screen against sanctions lists. | |
| No | Email address to verify. | ||
| phone | No | Phone number, international (+44 20 7946 0958) or national with `phone_region`. | |
| country | No | Country the person says they are in (US or United States), compared with phone and IP. | |
| language | No | Optional BCP-47 language tag (en, ja, ko, pt-BR): the human-readable strings of the result (notes, details, reasons) are translated into this language; data, codes, numbers and URLs are untouched. Default: as produced. | |
| birth_year | No | Birth year, to narrow sanctions matches for a person. | |
| phone_region | No | Two-letter country for a national-format phone number. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | ||
| status | Yes | ||
| worker | Yes | ||
| price_usd | Yes | ||
| provenance | Yes | ||
| receipt_id | Yes | ||
| attribution | No | ||
| receipt_url | Yes | ||
| billing_warning | No |