Qualify a business lead or counterparty
qualify_counterpartyBefore you engage with a business that contacted you (a form submission, an inquiry, an outreach reply), qualify it. Pass the sender's e-mail (or the company domain), the company name if given, and the context (form type, message, stated value, stated role). Jid checks the domain (MX, SPF, DMARC, registration date over RDAP, the website), matches it to a Jid business file, reads that file's registrations, licences, filings, capital raises, loans and adverse records, and returns signals (each with source, source_url, verified_at), three scores (legitimacy, capacity, consistency, 0 to 100 with reasons), checks (each pass, fail or unknown with one line of evidence and a lookup link) and a read: a one-line headline ("Passed all 7 checks Jid could run. Recommendation: engage."), the recommendation (engage, verify_first, do_not_engage), the failed checks and up to 4 links to verify by hand. Show the user the read first. Also a signed receipt. Businesses only: personal webmail or no matched business returns individual_or_unverified with no scores. A possible list match is 'review', never a finding. Requires an API key; counts as 2 checks. Not for credit, employment, insurance or housing decisions about any person.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | No | The submitting website's domain (binds the signal token) | |
| No | Sender's e-mail address | ||
| domain | No | Company domain, when no e-mail is available | |
| ip_asn | No | ASN of the submitting network, to recognise hosting and VPN networks | |
| policy | No | How cautious `engage` is (default balanced) | |
| signal | No | Jid Signals token (the form's jid_signal field): Jid's own reading of the visitor's location; replaces the ip_* fields when it verifies | |
| country | No | Stated country, ISO 3166-1 alpha-2 | |
| message | No | The submission's free text (hashed, never stored) | |
| summary | No | Add a short plain-English summary grounded in the signals | |
| activity | No | Regulated activity whose licences matter, if any | |
| form_type | Yes | What kind of submission this is | |
| ip_region | No | Region the submission came from (ISO 3166-2, e.g. US-CA or CA) | |
| ip_country | No | Country the submission came from, ISO alpha-2 (location consistency check) | |
| stated_role | No | The sender's stated role | |
| company_name | No | Company name as stated by the sender | |
| stated_value | No | Deal or purchase size the sender states, USD | |
| stated_country | No | Country the submitter stated (same as country) | |
| claimed_website | No | For vendor_claim / listing_claim: the website of the business or listing being claimed (enables the affiliation check) | |
| browser_timezone | No | IANA time zone reported by the submitter's browser |