Data reference

Every data field available through Vainu API is described here. These data fields can be used in fields parameter to pick fields to return. See Filtering guide for data fields available for filtering.

Root level data

Root level data returned by the API. These fields can be used at the fields parameter to modify the response of Get companies endpoints.

Data field	Data type	Description
accounting_firm	string	Auditor of the company, as seen in the financial statement
address	string	Company's registered address
address_count	integer	Total number of addresses found for the company
addresses	array(object)	All identified addresses for the company
address_country	string	Country of where the registered address is located
address_details	object	Additional details of registered address
alexa_country_code	string	Country that the company website is registered in for Alexa ranking
alexa_rank_country	integer	Country specific Alexa rank for the company
alexa_rank_delta	integer	Change in the company's Alexa rank since the previous measuring date
alexa_rank_global	integer	Global Alexa rank for the company
alexa_rank_reach	integer	Alexa Reach metric
area	integer	Finnish post number area
avg_num_videos_per_month	float	Average number of videos posted per month on the company's Youtube channel
basic_modified	date-time	Timestamp when the basic data of the company has been updated
bookkeeping_firm	string	Accounting firm for the company, as seen in the financial statement
bookkeeping_firm_normalized	string	Normalized name for the company's accounting firm
branch_number	string	Number of local branches identified for the company
branch_status	string	Whether company is part of a brach
bs_total_current_liabilities	float	Sum of total current liabilities, as seen on the balance sheet
business_id	string	Company's local business identification number (state registration number in the U.S.)
career_page_job_count	integer	Numer of open jobs counted on the company's career page
cash_flow_from_op_percent	float
charges	array	List of company charges
city	string	City where the registered address is located
company_hiring_links	array(string)	Link to the company's career page (can be multiple)
company_level	integer
company_name	string	Official name of the company
company_name_unofficial	string	Unofficial business names linked to the company
company_names	array(string)	All variations of company names identified for the company
companynews_links	array(string)	Links to the pages with company news articles on the company's website
company_rss_links	array(string)	Links to all identified rss feeds on the company's website
contact_page_urls	array(string)	Links to the pages on company's website with contact information
contacts	array(object)	All the contact details identified for the company
content_career_page	string	Full text of the company's career page
coordinates	object	Coordinates for the registered address of the company
country	string	Country the company's registered address is in
county	string	County the company's registered address is in
crawled_datetime	date-time	Date that the original entity was crawled into the database
currency_code	string	Main currency used by the company as seen in the financial statement (USD, EUR)
deregistration_date	date-time	Date when company was removed from official registry
description	string	Text description of the company, extracted from public profiles
development_of_turnover	float	Change in revenue in percentage from the previous year, as found on the balance sheet
development_of_turnover_class	integer
digitality	float	A score (between 0-1, 1 being maximum) that characterizes how digitally advanced the company is
dissolution_mode	string	Type of dissolution
dissolution_registration_date	date-time	Date the company was dissolved
dissolution_successors	array(string)	Business id's the company has dissolved to
dividend	float	Paid dividends, as seen on the balance sheet
dividend_local	float	Dividends paid out as seen on the balance sheet. In local currency
domain	string	Website URL of the company
domains	array(string)	Other website URLs identified for the company
e_invoice_addresses	array(object)	The electronic invoice address of the company (Europe only)
email	string	General email address for the company (e.g. [email protected])
employee_salary	float
employer_register_date	date-time	Date the company joined the employer registry (Europe only)
employee_salary_local	float	Total cost of employee salaries as found on the balance sheet
equity_to_assets_ratio	float	The equity to assets ratio, as found on the balance sheet
expiration_date	date-time	Date when company will go inactive without renewal of registration
expired_data	object	Collection of expired data of the company
facebook_engagement_rate	float	Engagement rate of the company's Facebook page
facebook_likes	integer	Number of likes on the company's Facebook page
facebook_link	string	Link to the facebook page of the company
facebook_posts_per_day	float	Average number of posts on the company's Facebook page per day
facebook_ptat	integer	People talking about this -metric for the company's Facebook page
fax	string	Fax number of the company
financial_statements_consolidated	array
financial_statements	array(object)	Full data from the financial statement per year
financial_statement_keywords	array(string)	Collected keywords from financial statement
form_of_company	string	Company's official form of business (limited liability company, corporation etc.)
form_of_company_details	object	Details of form of company
form_of_company_n	array(string)
form_of_company_vainu	integer
form_of_registration	string
foundation_date	date-time	Date the company was founded.
funding_rounds	array(object)	Funding rounds raised by the company
group_data	object	Details of the group and the highest entity in the group
identity	array(object)	Themes, groups and registers company is associated to
industry_codes	array(string)	All industry codes identified for the company
industry_codes_main_local	array(string)	Official local industry codes
industry_codes_other_local	array(string)
industry_description	array(string)	Description of the industry code
instagram_link_count	integer	Number of links on the website to Instagram
jurisdiction	string	State under whose laws the company operates
kr_gross_profit_margin_percent	float	Percentage of gross profit out of total revenue
kr_net_margin_percent	float	Percentage of revenue remaining after all operating expenses, interest and tax
kr_turnover_per_employee	float	Company's revenue divided by their employee count, as found on the balance sheet
kr_turnover_per_employee_local	float	Company's revenue divided by their employee count, as found on the balance sheet. In local currency
kr_quick_ratio_percent	float	Company's quick ratio as found on the balance sheet
lat	float	Latitude of the company's registered address
licenses	array(object)	Licenses granted for the company
link	string	Website URL of the company
linkedin_id	string	Company's Linkedin identifier in numeric format (e.g. linkedin.com/12345 = 12345)
linkedin_industry	string	Linkedin Industry of the company
linkedin_link	string	Link to the company's Linkedin profile
lng	float	Longitude of the company's registered address
marketility	float	A score (between 0-1, 1 being maximum) that characterizes how advanced the company is with marketing technologies
modifications	object	Timestamps for data updates on specific data categories
mother	string	Official company name of the parent company
mother_foreign	string	Foreign parent company of the organization
municipality	string	County of the company's registered address
num_subscribers_per_1000_views	float	Average number of subscribers per 1000 views on a company's Youtube page
official_status		Official status of the company from the official source
owned_percent	float
owners	array(object)	Known owners which own partially or fully the requested company
paye_register_date	date-time	Date when company was added to official PAYE register
payroll_overhead	float	Total costs of payroll, as found in the balance sheet
payroll_overhead_local	float	Total costs of payroll, as found in the balance sheet. In local currency
phone	string	Main phone number for the company
postal	string	Zip code for the company's registered address
products	array(object)	List of products by the company
profit	float	Profit for the company, as found in the financial statement
profit_estimate	float	Estimate of the generated profit for the year
real_estate	object	Real estate data. Extra permission required
region	string	State the company's registered address is in
registers	array(object)	Public registers that the company is listed on (e.g. export registry)
registration_date	date-time	Date the business was registered with the local business authority (e.g. State)
registry_url	string	Source for the original entity information from the business registry
related_links	array(object)	Urls related to company (ie. wikipedia)
restricted_for_marketing	boolean	Whether company is restricted for marketing
result_before_taxes	float	Company's earnings before interest and taxes (EBIT)
right_of_sign	string	Who has the right to sign for the company (e.g. board members), as found on the balance sheet
rss_feeds	object	Links to RSS feeds found on the company website
salary_board	float	Compensation the board of the company receives, as seen in the financial statement
salary_board_local	float	Compensation the board of the company receives, as seen in the financial statement. In local currency
social_profiles	array(object)	Company's social media handles in different social media channels
sociality	float	A score (between 0-1, 1 being maximum) that characterizes how advanced the company is with social media technologies
staff_cls	integer
staff_number	integer	Company's employee count
staff_number_estimate	integer	Estimated employee count for the company
staff_number_is_estimate	boolean	Is staff number estimate instead of accurate value
staff_number_lowerlimit	integer	Lower limit of the company's employee count range, when applicable
staff_number_upperlimit	integer	Upper limit of the company's employee count range, when applicable
state_registration	string
status	string	Current official registration status of the company
status_registration_date	date-time
stock_exchange	string	Location of the stock exchange the company is listed in
stock_exchange_date	date-time	Date the company was listed on the stock exchange
stock_symbol	string	Stock symbol (Ticker) for the company
structure	array(object)
technologies	array(string)	List of technologies used by the company
themes	array(string)	Labels given by Vainu to characterize the company (actively hiring, cloud service enthusiast etc.)
total_funding_usd	float	Total sum of funding the company has received (USD)
turnover_cls	integer
turnover_estimate	float	Estimated revenue for the company
turnover_estimated_date	date-time	Date the revenue was estimated using Vainu's revenue estimator
turn_over	float	Exact revenue of the company
turn_over_is_estimate	boolean	Is turn over estimation instead of accurate value
turn_over_local	float	Revenue of the company in local currency
turn_over_lowerlimit	float	Lower limit of the company's revenue range, when applicable
turn_over_upperlimit	float	Upper limit of the company's revenue range, when applicable
twitter_followers_count	integer	Number of Twitter followers
twitter_link	string	Link to the company's Twitter profile
vainu_custom_industry	array(object)	Custom industries of the company issued by Vainu
vainu_link	string	Link to the Vainu company profile in Vainu platform
vainu_public_link	string	Link to public Vainu company profile
vainu_score	float	Score (0-100) describing completeness of the company profile in Vainu's database
vainu_social_score	float
vainu_status	string	Vainu status of the company. Either Active or Inactive.
vat_number	string	VAT number of the company
vat_property_register_date	date-time	Date the company joined the local property registry (Europe only)
vat_register_date	date-time	Date the company joined the VAT registry (Europe only)
verified_domains	array(string)	All verified website URLs for the company
vid	integer	Company's unique Vainu identifier
visiting_address	string	Visiting address of the company
visiting_address_country	string	Country where the company's visiting address is located
visiting_city	string	City of the company's visiting address
visiting_coordinates	object	Coordinates for the company's visiting address
visiting_country	string	Country where the company's visiting address is located
visiting_county	string	County of the company's visiting address
visiting_lat	float	Latitude of the company's visiting address
visiting_lng	float	Longitude of the company's visiting address
visiting_municipality	string	County that the company's visiting address is located in
visiting_postal	string	Zip code of the company's visiting address
visiting_region	string	State the company's visiting address is located in
website_metadata	object	Metadata and keywords of website content
website_page_count	integer	Total number of pages found on the company's website
websites	array(string)	Websites
www_index_ip	string	Company's website IP address
youtube_comment_count	integer	Number of comments on videos posted on the company's Youtube page
youtube_link	string	Link to the company's Youtube page
youtube_subscriber_num	integer	Number of subscribers on the company's Youtube page
youtube_video_count	integer	Number of videos posted on the company's Youtube channel
youtube_view_count	integer	Number of views on the company's Youtube page

Addresses

Addresses array of objects returned by API.


address	string	Street address of the location
address_care_of
address_country	string	Country of the location
address_details	object	Details of the address (see Address details)
business_id	string	Business Id of the location
city	string	City of the location
coordinates	object	Coordinates of the location (see Coordinates)
country	string	Country for the location
email	string	Email address of the location
industry_codes	array(string)	Industry codes of the location
industry_codes_all	array(string)	Industry codes of the location
lat	float	Latitude of the location
lng	float	Longitude of the location
modified	date-time	Timestamp when the data for the location has been updated
municipality	string	Municipality of the location
office_name	string	Name of the location
office_number	string	Official office number of the location
office_type	string	Type of the location
phone	string	Phone number of the location
postal	string	Postal code for the location
region	string	Region of the location
restaurant	object	Restaurant specific data
staff_number	integer	Staff number of the location
staff_number_lowerlimit	integer	Lower limit for the staff number range for the location
staff_number_upperlimit	integer	Upper limit for staff number range for the location
start_date	date-time	Foundation data of the location
types	array(string)	Types of the location
uid	string	Unique identifier of the location
visiting_address	string	Visiting street address of the location
visiting_address_care_of	string
visiting_address_country	string	Country for the visiting address of the location
visiting_address_details	object	Details of the visiting address (see Address details)
visiting_city	string	City for the visiting address of the location
visiting_lat	float	Latitude of the visiting address for the location
visiting_lng	float	Longitude of the visiting address for the location
visiting_municipality	string	Municipality of the visiting address of the location
visiting_postal	string	Postal code for the visiting address of the location

Address_details

Address details object found in addresses.

Data field	Data type	Description
care_of
entrance	string	Entrance of the address
floor	string	Floor of the address
instructions	string	Instructions for the address
po_box	string	PO Box of the address
property_unit_number
street_name	string	Street name of the address
street_number	string	Street number of the address

Coordinates

Coordinates object.

Data field	Data type	Description
type	string	Type of coordinates (ie. point)
coordinates	array(float)	List of coordinates

Contacts

Contacts array of objects returned by the API.

Data field	Data type	Description
email	string	Email of the contact
first_name	string	First name of the contact
last_name	string	Last name of the contact
modified	date-time	Timestamp when the contact has been updated
phone	string	Phone number of the contact
title	string	Title of the contact
titles	array(object)	Titles of contact
titles.title	string	Title of the contact
titles.title_cls	string	Normalised title for the contact
uid	string	Unique id of the contact

E_invoice_addresses

E-Invoice address array of objects returned by the API.

Data field	Data type	Description
e_invoice_address	string	E-Invoice address
invoice_address_name	string	Name of the e-invoice address
operator_business_id	string	Business id of the e-invoice operator
operator_id	string	Id of the e-invoice operator
operator_name	string	Name of the e-invoice operator
receive	boolean	Receive status of the address
send	boolean	Send status of the address

Financial_statements

Financial statements array of objects returned by the API.

Data field	Data type	Description
account_period_end	date	Date when account period for financial statement ends
account_period_start	date	Date when account period for financial statement start
bs_cash_and_cash_equivalents	float	Cash and cash equivalents are the most liquid current assets found on the company's balance sheet.
bs_cash_and_cash_equivalents_local	float	Cash and cash equivalents are the most liquid current assets found on the company's balance sheet. In local currency.
bs_debenture_loans	float
bs_deferred_tax_assets	float
bs_deferred_tax_assets_local	float
bs_dividend	float
bs_dividend_local	float
bs_given_or_received_intra_group_contribution	float
bs_given_or_received_intra_group_contribution_local	float
bs_investments_in_associated_companies	float
bs_investments_in_associated_companies_local	float
bs_investments_in_subsidiaries	float
bs_investments_in_subsidiaries_local	float
bs_issued_share_capital	float
bs_issued_share_capital_local	float
bs_long_term_bank_loans	float
bs_long_term_bank_loans_local	float
bs_operating_movable_property	float
bs_operating_movable_property_local	float
bs_other_long_loans	float
bs_other_long_loans_local	float
bs_patents_licenses_and_trademarks	float
bs_patents_licenses_and_trademarks_local	float
bs_pension_liabilities	float
bs_pension_liabilities_local	float
bs_retained_equity	float
bs_retained_equity_local	float
bs_short_term_debt_to_group_companies	float
bs_short_term_debt_to_group_companies_local	float
bs_short_term_debt_to_suppliers	float
bs_short_term_debt_to_suppliers_local	float
bs_short_term_other_creditors	float
bs_short_term_other_creditors_local	float
bs_short_term_other_receivables	float	The sum of short term receivables that do not belong to any of the other short term receivable fields.
bs_short_term_other_receivables_local	float	The sum of short term receivables that do not belong to any of the other short term receivable fields. In local currency.
bs_tax_payable	float
bs_tax_payable_local	float
bs_total_allowances_for_liabilities	float
bs_total_allowances_for_liabilities_local	float
bs_total_assets	float	The total value of the company's assets.
bs_total_cash_and_cash_equivalents	float	Cash and cash equivalents.
bs_total_cash_and_cash_equivalents_local	float	Cash and cash equivalents. In local currency
bs_total_current_assets	float	Current assets are all the assets of a company that are expected to be sold or used as a result of standard business operations over the next year
bs_total_current_assets_local	float	Current assets are all the assets of a company that are expected to be sold or used as a result of standard business operations over the next year. In local currency.
bs_total_current_liabilities	float	Short-term (current) liabilities are financial obligations that the company needs to pay within one year.
bs_total_current_liabilities_local	float	Short-term (current) liabilities are financial obligations that the company needs to pay within one year. In local currency.
bs_total_equity	float	Equity represents the value that would be returned to a company's shareholders if all of the assets were liquidated and all of the company's debts were paid off.
bs_total_equity_and_liab	float	The total value of the company's equity and liabilities.
bs_total_equity_and_liab_local	float	The total value of the company's equity and liabilities. In local currency.
bs_total_fix_assets	float
bs_total_fix_assets_local	float
bs_total_fixed_financial_assets	float
bs_total_fixed_financial_assets_local	float
bs_total_intangible_assets	float
bs_total_intangible_assets_local	float
bs_total_long_term_assets	float
bs_total_long_term_assets_local	float
bs_total_long_term_debts	float
bs_total_long_term_debts_local	float
bs_total_other_long_term_debt	float
bs_total_other_long_term_debt_local	float
bs_total_paid_equity	float
bs_total_paid_equity_local	float
bs_total_receivables	float
bs_total_receivables_local	float
bs_total_retained_earnings	float	The amount of earnings retained by the company. Earnings not paid out to shareholders as dividends
bs_total_retained_earnings_local	float	The amount of earnings retained by the company. Earnings not paid out to shareholders as dividends. In local currency
bs_total_tangible_assets	float
bs_total_tangible_assets_local	float
bs_value_added_tax_payable	float
bs_value_added_tax_payable_local	float
created	date-time	Timestamp when the financial statement has been created
currency_code	string	Currency of the financial statement
depreciation_costs	float	The total depreciation costs
depreciation_costs_local	float	The total depreciation costs. In local currency.
development_of_net_income	float	Change percentage of net income
development_of_turnover	string	Percentage revenue has changed
dividend	float
dividend_local	float
employee_salary	float	Employee salary costs.
employee_salary_local	float	Employee salary costs. In local currency.
equity_to_assets_ratio	string	A financial ratio that measures the level of leverage used by a company, the equity ratio quantifies the proportion of the total assets that are financed by stockholders, and not creditors (or debt)
income_tax	float	The amount of tax paid from the income of the company.
income_tax_local	float	The amount of tax paid from the income of the company. In local currency
insolvency_date_type	array
kr_asset_turnover	float
kr_current_ratio	float	The current ratio is a liquidity ratio that measures a company's ability to pay short-term obligations or those due within one year.
kr_debt_to_equity	float
kr_net_margin_percent	float
kr_return_on_assets	float	Return on assets (ROA) is an indicator of how profitable a company is relative to its total assets.
modified	date-time	Timestamp when the financial statement has been modified
net_financial_items	float
net_financial_items_local	float
net_income_euro	string	The earnings of the company after all costs, interests and taxes have been deducted (the bottom line).
net_income_local	string	The earnings of the company after all costs, interests and taxes have been deducted (the bottom line) in local currency.
net_operating_income	float
net_operating_income_local	float
operating_income	float
operating_income_local	float
ordinary_result_after_taxes	float
ordinary_result_after_taxes_local	float
other_financial_expenses	float
other_financial_expenses_local	float
other_financial_income	float	Financial income.
other_financial_income_local	float	Financial income. In local currency.
other_interest_expenses	float
other_interest_expenses_local	float
other_interest_income	float
other_interest_income_local	float
other_operating_expenses	float
other_operating_expenses_local	float
other_operating_income	float
other_operating_income_local	float
profit	string
quick_ratio_percent	float
result_before_taxes_euro	string	Earnings before interest and taxes. This is an indicator of the company's profitability.
result_before_taxes_local	string	Earnings before interest and taxes. This is an indicator of the company's profitability in local currency.
return_on_equity	float
return_on_investment	float
share_of_profit_from_subsidiaries	float
share_of_profit_from_subsidiaries_local	float
staff_number_is_estimate	boolean
sum_of_turnover_development_and_profit_margin	float
sum_of_turnover_net_income_developments	float
total_assets	float	The total value of the company's assets.
total_costs	float
total_costs_local	float
total_equity	float	Equity represents the value that would be returned to a company's shareholders if all of the assets were liquidated and all of the company's debts were paid off.
total_financial_expenses	float
total_financial_expenses_local	float
total_financial_income	float
total_financial_income_local	float
total_liabilities	float	The total value of the company's liabilities.
total_liabilities_local	float	The total value of the company's liabilities. In local currency.
total_transfers_and_allocations	float
transfers_to_retained_earnings	float
transfers_to_retained_earnings_local	float
turn_over_eur	string
turn_over_is_estimate	boolean
turn_over_local	float	Revenue in local currency
year	integer	Year of the financial statement

Form_of_company_details

Details of the form of company returned by the API.

Data field	Data type	Description
code	string
description	string	Description of form of company
form_of_company	string	Form of company

Group_data

Group data object returned by the API

Data field	Data type	Description
company_level	integer	Level of the company in the group hierarchy (1 is the parent)
countries	array(string)	Countries the companies of the group operate in
currency_code	string	Currency code of the group
group_name	string	Name of the group
group_parent_business_id	string	Business id of the parent company
group_parent_company_name	string	Name of the parent company
group_parent_country	string	Country of the parent company
staff_number	integer	Total staff number of the group
turn_over_eur	float	Total revenue of the group in EUR
turn_over_local	float	Total revenue of the group in local currency

Identity

Identity array of objects returned by the API.

Data field	Data type	Description
type	string	Type of identity
value	string	Theme, group or register name

Organization_size_indicators

Data field	Data type	Description
size_classes	array(string)	Verbal description of size class. Possible values are: micro, small, medium, large, enterprise
indicator_type	string	Type of indicator model. Possible values: company_size_indicator_model, linkedin_employee_count_estimate, linkedin_company_size
value_range.lower_limit	integer	Lower limit of estimation range
value_range.upper_limit	integer	Upper limit of estimation range

Owners

Owners array of objects returned by the API.

Data field	Data type	Description
business_id	string	Business id of the owner if company
company_name	string	Company name of the owner if company
country	string	Country of the owner
modified	date-time	Timestamp when owner data has been updated
owned_percent	float	Percentage owned
owner_name	string	Name of the owner
owner_type	integer	Owner type

Real_estate

Real estate object returned by the API.

Data field	Data type	Description
amenities	array(string)	List of amenities and public spaces
building_apartment_count	integer	Number of apartments
building_type	string	Type of the building
building_year	integer	Year the building was built
commercial_apartments	string	Number of commercial apartments
construction_material	string	Construction material(s)
energy_class	string	Energy class
floors_building	integer	Number of floors
heating_system	string	Heating system
land_owner	string	Owner of the land
land_ownership	string	Land ownership status
land_rental	float	Rental cost of the land
land_size_building	integer	Size of the land in square meters
parking_spaces	integer	Number of parking spaces
property_maintenance_company	string	Name of the property maintenance company
property_management_company	string	Name of the property management company
renovations_coming	array(string)	List of upcoming renovations
renovations_done	array(string)	List of renovations done
roof_material	string	Roof material
roof_type	string	Roof type

Registers

Registers array of objects returned by the API.

Data field	Data type	Description
authority	string	Authority behind the register
country	string	Country of the register
register	integer
register_name	string	Name of the register
status	integer
status_description	string

Related_links

Related links array of objects returned by the API.

Data field	Data type	Description
countries	array(string)	Countries the link is related to
description	string	Description of the link content
language_codes	array(string)	Language codes of the content
link	string	Related link
title	string	Title of the link content
types	array(string)	Types of the related link (ie. wikipedia)

Social_profiles

Social profiles array of objects returned by the API.

Data field	Data type	Description
description	string	Description of company from the social media
followers	integer	Number of followers
following	integer	Number of accounts followed
link	string	Link to the social media account
type_id	string	Type of social media
userid	string	User id of the company at the social media
username	string	Username of the company at the social media

Vainu_custom_industry

Vainu custom industry array of objects returned by the API.

Data field	Data type	Description
confidence_class	string	Simplified confidence score with values "high" or "low"
confidence_score	float	Confidence score of the AI how likely this industry is accurate (0 to 1)
confidence_thresholds	array(float)	Threshold for this industry when Vainu interprets the confidence as "high"
source_version	string	Version of industry classifier used
type	string	Type of industry classification
value	string	Vainu custom industry name

Website_metadata

Website metadata object returned by the API.

Data field	Data type	Description
keyword_frequency	object	Website keywords with number of occurrences
total_word_count	integer	Total number of keywords on the website

Modifications

Modifications object returned by the API.

Data field	Data type	Description
any	date-time	Timestamp when any data has been updated
basic_data	date-time	Timestamp when basic data has been updated
contacts	date-time	Timestamp when contact data has been updated
financial_statements	date-time	Timestamp when financial data has been updated
prospect_addresses	date-time	Timestamp when address data has been updated
related_links	date-time	Timestamp when related links data has been updated