The company_verification module confirms a company you can precisely identify, and checks claims about it. You give it an exact identifier (a website or Veridion ID) plus the claims you want to test ("is it in Germany?", "does it mention ISO 9001?", "is it a manufacturer?"), and it returns a verdict per claim.
Who uses it: insurance underwriters confirming a submitted company; TPRM, KYB, and compliance teams verifying and screening onboarding companies at scale.
Verification confirms; it doesn't enrichThe payload of this module is the verdicts, not a company profile. If you need the full profile of a verified company, you can fetch it using the Firmographics API.
Input contract
| Requires | an exact identity anchor: company_website or veridion_id, with in (a single company, or a subset as an array). |
| Allows | claim-check filters: company_keywords, company_location, company_postcode, target_markets, and firmographic or classification filters (company_industry, company_category, company_naics_code, company_business_model, company_type, company_estimated_revenue, company_employee_count, company_year_founded). |
| Rejects | company_name (verification is exact-only; use company_lookup); not_in on the identity anchor. |
company_productsclaim-checks are not in v5You can't verify a product claim directly in v5. To check a capability claim, use
company_keywordsas a text check instead.
Behavior
Search resolves the identity and returns the identified company with a verdict for every check filter you provided. It is deterministic and 1:1. Two rules matter:
- A company is returned whenever its identity resolves, even if the claim-checks fail. Identity is what returns a row; the verdicts tell you which claims passed and which didn't. This is the one module where
matched: falseis a meaningful, returned outcome. - Identifiers that don't resolve to a company are omitted from the response, so every returned object is a real company.
Output
Verification returns a minimal identity stub (veridion_id, company_name, and website_domain) plus the per-check evidence - the verdicts are the value. See Response fields and types.
Each check appears in evidence as { "matched": <bool>, "value": <witness | null> }: on a pass, value is the witness that proves it (the matched snippet, value, or location); on a fail or a negation, value is null. See Explainability (evidence) for the evidence shape of each filter type and the sufficiency rules.
Request
Confirm a single company and check several self-reported claims at once (here, a KYB onboarding check that the applicant is a US-domiciled private SaaS/B2B company, founded around 2019, with 500 to 1000 employees):
{
"module": "company_verification",
"query": {
"and": [
{
"attribute": "company_website",
"relation": "in",
"value": [
"highnote.com"
]
},
{
"attribute": "company_type",
"relation": "in",
"value": [
"Private"
]
},
{
"attribute": "company_business_model",
"relation": "in",
"value": [
"Software-as-a-Service"
]
},
{
"attribute": "company_business_model",
"relation": "in",
"value": [
"Business-to-Business"
]
},
{
"attribute": "company_year_founded",
"relation": "between",
"value": [
2018,
2020
]
},
{
"attribute": "company_employee_count",
"relation": "between",
"value": [
500,
1000
]
},
{
"attribute": "company_location",
"relation": "in",
"value": [
{"country":"US"}
],
"strictness": 1
}
]
}
}Each claim comes back as its own pass or fail verdict, so a company whose identity matches but whose checks don't still returns, with the failed checks marked:
{
"next_cursor": null,
"has_more": false,
"search_module": "company_verification",
"result_count": 1,
"result": [
{
"evidence": {
"company_website": {
"matched": true,
"value": "highnote.com"
},
"company_type": {
"matched": true,
"value": [
"Private"
]
},
"company_business_model": {
"matched": true,
"value": [
"Software-as-a-Service",
"Business-to-Business"
]
},
"company_year_founded": {
"matched": true,
"value": 2020
},
"company_employee_count": {
"matched": false,
"value": null
},
"company_location": {
"matched": true,
"value": [
{
"address_string": "642 Harrison St Ste 100, San Francisco, 94104, California, United States",
"location_role": "main"
}
]
}
},
"veridion_id": "4PSR6OXE72YNRL3L",
"company_name": "Highnote",
"website_domain": "highnote.com"
}
]
}Special scenarios
- Verify a subset in one call. Pass an array to the identity anchor (
"value": ["a.com", "b.com", …]). Large lists paginate. - Presence-in-an-area check. Use
company_locationwithwithin({ address, radius, unit }) to test whether a company operates inside a peril or risk zone. - Risk or claim scan. Use
company_keywordsto check whether a company's content mentions a term (a certification, a risk signal, a capability).