Response fields and types

Field name (key)	Type	Description
search_details	`JSON object`	An object that provides insight into why a particular query was matched against the Veridion database. [Note: present only for Product Search, Keyword Search ][Note: present only for Product Search, Keyword Search ]
search_details.product_match	`JSON object`	An object that provides insight into why a particular product query was matched against the Veridion database. [Note: present only for Product Search][Note: present only for Product Search]
search_details.product_match .context*	`JSON object`	An object that provides additional context on the product matched through the Product Search query.
search_details.product_match .context.headline*	`string`	A snippet that refers to the product name, the name of the product category, the product line, the product collection, or the specific capability of a manufacturer.
search_details.product_match .context.content*	`string`	A larger, more descriptive paragraph of text associated with the content of the "Product Headline" (see above).
search_details.product_match .context.url*	`string`	The source URL where the product was identified and extracted from.
search_details.product_match .context.snippets*	`array`	A list of text snippets that best match the search terms. This can be part of the "Product Content" (see above) or a completely different snippet associated with the same result (e.g., a snippet that explains a product/service characteristics).
search_details.product_match .supplier_types*	`array`	Indicator of whether the company is a manufacturer, distributor, or service provider.
search_details.keyword_match	`JSON object`	An object that provides insight into why a particular keyword query was matched against the Veridion database. [Note: present only for Keyword Search][Note: present only for Keyword Search]
search_details.keyword_match .context*	`JSON object`	An object that provides additional context on the keywords matched through the Keyword Search query.
search_details.keyword_match .context.snippets*	`array`	A list of text snippets that best match the search terms.
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).
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".
company_type	`string`	"Public" for companies listed on the stock exchange. "Private" for privately held companies.
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.
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.