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

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

???

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

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