Response fields and types

Field name (key)	Type	Description
match_details	`JSON object`	An object that provides insight into why a particular set of inputs was matched against the Veridion database. It is designed to offer better understanding of the matching process, and enable refined filtering in the future.
match_details.confidence_score	`decimal`	Numerical value that indicates the level of confidence for a match. Ranges from `0` to `1`, with higher values indicating greater confidence in the match.
match_details.matched_on	`array`	The set of attributes that were matched against the Veridion database using the provided input ( e.g. company name, location, website etc. ). Additional information is available here.
match_details.attributes	`JSON object`	Additional context on why attributes listed in the `matched_on` set were matched. Includes information such as confidence scores, values matched, source and type of the match, broken down per matched attribute. Some attributes can include additional information. Additional information is available here .
veridion_id	`string`	Veridion internal company ID.
company_name	`string`	The most commonly used name when referring to this entity; may either be its legal or commercial name (in some cases, the commercial name is an abbreviation of the company name).
registered_name	`string`	Company legal name as provided by the local registry that the company incorporated with.
company_commercial_names	`array`	Commercial names by which the company is known, which might differ from its legal name. For example, while the legal name could be "The Acme Inc.", the company is commonly referred to using the commercial name: "Acme".
company_legal_names	`array`	The main legal name of the company, including its historical variations and past legal names are the names employed in documents such as the Privacy Policy and other legal records.
main_address	`JSON object`	The address where the company's HQ is located.
main_address.country_code	`string`	The two-digit ISO code of the country in which the company's HQ is located.
main_address.country	`string`	The name of the country in which the company's HQ is located.
main_address.region	`string`	The name of the region in which the company's HQ is located.
main_address.city	`string`	The name of the city in which the company's HQ is located.
main_address.street	`string`	The name of the street on which the company's HQ is located.
main_address.street_number	`string`	The street number associated with the HQ street name.
main_address.postcode	`string`	Postcode associated with the company's HQ.
main_address.latitude	`decimal`	The company's HQ latitude coordinates.
main_address.longitude	`decimal`	The company's HQ longitude coordinates.
locations	`array`	Top 10 company locations (includes HQ and all secondary locations).
locations.country_code	`string`	The two-digit ISO code of the country for the company location(s).
locations.country	`string`	Full country name of the company location(s).
locations.region	`string`	State, geographical region or province for the company location(s) (where applicable).
locations.city	`string`	The city associated with the location.
locations.street	`string`	The street name associated with the location.
locations.street_number	`string`	The street number associated with the street name.
locations.postcode	`string`	Postcode associated with the location.
locations.latitude	`decimal`	The location's latitude coordinates.
locations.longitude	`decimal`	The location's longitude coordinates.
num_locations	`integer`	The count of physical locations attributed to the company. Includes offices, retail locations, manufacturing plants and other location types. Depending on the company, this number might not necessarily match the "Number of offices".
registered_address	`JSON object`	Legal address of registration, as provided by the registry with which this company incorporated. The legal address might differ from the operational (office) locations of the company.
registered_address.country_code	`string`	Full country name of the company registered address.
registered_address.country	`string`	Full country name of the company registered address.
registered_address.region	`string`	State, geographical region or province for the company registered address (where applicable).
registered_address.city	`string`	The city associated with the registered address.
registered_address.street	`string`	The street name associated with the registered address.
registered_address.street_number	`string`	The street number associated with the street name.
registered_address.postcode	`string`	Postcode associated with the registered address.
registered_address.latitude	`decimal`	The registered address's latitude coordinates.
registered_address.longitude	`decimal`	The registered address's longitude coordinates.
jurisdiction	`string`	The jurisdiction where this company incorporated. In most territories it's the country, but in others it's the region (e.g. in Switzerland) or the state (e.g. in the United States).
legal_form	`string`	The legal form of the company (e.g. "Limited Liability Company")
company_type	`string`	"Public" for companies listed on the stock exchange. "Private" for privately held companies.
company_status	`string`	The company's status as provided by the registry (Active / Inactive)
year_founded	`integer`	Founding year for the company. If the company is a component of a larger or older organization, the founding year corresponds to that of the parent organization.
incorporation_date	`string`	The exact date of incorporation for the legal entity. ISO format YYYY-MM-DD e.g. 2024-02-23 .
lei	`string`	The ID of the company, if the company registered for a Legal Entity Identifier (LEI).
ein	`string`	US Employer Identification Number, if the company registered for an EIN.
vat_id	`string`	Value Added Tax ID, in countries and territories that require a VAT ID (especially countries in Europe).
tin	`string`	Unique identification number issued by a government tax authority for entities to track their tax obligations. Different countries have different systems for assigning TINs.
registry_ids	`array`	Array of local Unique IDs, as provided by the local registry where this legal entity is incorporated.
employee_count	`JSON object`	The number of people employed by the company, as communicated by the company or modelled by Veridion's AI.
employee_count.value	`integer`	The number of people employed by the company
employee_count.type	`string`	"Extracted" for published values in sources used by Veridion "Modelled" for values modelled by Veridion's AI using official digital content published by the company.
revenue	`JSON object`	Company yearly revenue. For companies that publish their revenue numbers (e.g. public companies, Inc 5000 companies etc.), the value is the officially declared one. For other companies, the revenue is estimated based on publicly available numbers or modelled by Veridion's proprietary AI models.
revenue.value	`integer`	Company yearly revenue value
revenue.type	`string`	"Extracted" for values published in sources used by Veridion "Modelled" for values modelled by Veridion's AI.
main_business_category	`string`	Primary business category for the company, based on Veridion's ML classification model.
main_industry	`string`	Primary industry of activity for the company, based on Veridion's ML classification model.
main_sector	`string`	Primary sector of activity of the company, based on Veridion's ML classification model.
naics_2022	`JSON object`	The NAICS 2022 classification for the company (6-digit code).
naics_2022.primary	`JSON object`	Primary NAICS 2022 classification for the company.
naics_2022.primary.code	`string`	Primary NAICS 2022 code for the company.
naics_2022.primary.label	`string`	Primary NAICS 2022 label for the company.
naics_2022.secondary	`array`	Secondary NAICS 2022 classifications for the company.
naics_2022.secondary.code	`string`	Secondary NAICS 2022 code for the company.
naics_2022.secondary.label	`string`	Secondary NAICS 2022 label for the company.
nace_rev2	`array`	NACE classification for the company.
nace_rev2.code	`string`	NACE classification code for the company.
nace_rev2.label	`string`	NACE classification label for the company.
ncci_codes_28_1	`array`	NCCI classification codes for the company (4-digit code).
sic	`array`	SIC classification for the company (4-digit code).
sic.code	`string`	SIC classification code for the company (4-digit code).
sic.label	`string`	SIC classification label for the company (4-digit label).
isic_v4	`array`	ISIC classifications for the company (4-digit).
isic_v4.code	`string`	ISIC classification code for the company (4-digit code).
isic_v4.label	`string`	ISIC classification label for the company (4-digit label).
ibc_insurance	`array`	The company's IBC Mapping (5 levels deep).
ibc_insurance.code	`string`	The company's IBC Mapping code (5 levels deep).
ibc_insurance.label	`string`	The company's IBC Mapping label (5 levels deep).
sics_industry	`JSON object`	The SASB Sustainable Industry Classification Scheme (SICS) Industry of the company.
sics_industry.code	`string`	The SASB SICS Industry code of the company.
sics_industry.label	`string`	The SASB SICS Industry label of the company.
sics_subsector	`JSON object`	The SASB SICS subsector of the company.
sics_subsector.code	`string`	The SASB SICS subsector code of the company.
sics_subsector.label	`string`	The SASB SICS subsector label of the company.
sics_sector	`JSON object`	The SASB SICS sector of the company.
sics_sector.code	`string`	The SASB SICS sector code of the company.
sics_sector.label	`string`	The SASB SICS sector label of the company.
short_description	`string`	A short description of the business activities of the company. Value is extracted as presented in the digital source.
long_description_extracted	`string`	A longer description of the business activities of the company. Value is extracted as presented in the digital source.
long_description_generated	`string`	LLM generated description of the business activities of the company. Veridion developed LLMs use various digital sources to aggregate information and generate a structured description that includes information such as company name, founded year, parent information, stock information, product/services information, when available.
business_tags_extracted	`array`	Company attributes related to the company's activities. For example, a tech company may contain tags such as "startup", "SaaS", or "Artificial Intelligence". Values are extracted exactly as presented in the digital source.
business_tags_generated	`array`	LLM generated attributes related to the company's activities. Veridion developed LLMs use various digital sources to aggregate information and infer activities based on raw content. Generated tags can capture niche activities, business models, products, services and differentiators / unique traits of the company.
primary_phone	`string`	The primary phone number associated with the company.
phone_numbers	`array`	Additional phone numbers linked to the company, generally front-office phone numbers or departmental contact numbers.
primary_email	`string`	The primary email address associated with the company.
emails	`array`	Generic company email addresses linked to the company domain, such as "info@company" or "contact@company".
website_url	`string`	The URL of the main company website.
website_domain	`string`	The domain name of the main company website.
website_tld	`string`	Top-level domain of the company domain.
website_language_code	`string`	Primary language identified on the company website.
facebook_url	`string`	The company's Facebook URL.
twitter_url	`string`	The company's Twitter URL.
instagram_url	`string`	The company's Instagram URL.
linkedin_url	`string`	The company's LinkedIn URL.
ios_app_url	`string`	The company's iOS App Store URL.
android_app_url	`string`	The company's Google Play URL.
youtube_url	`string`	The company's YouTube channel URL.
technologies	`array`	Types of web technologies used by the company website and public assets, such as: Content Management System, Programming Language, or Other web components.
created_at	`string`	The UTC date and time when the company profile was initially added to the Veridion database.
last_updated_at	`string`	The UTC date and time when the information about the company was last extracted and verified for updates by Veridion.