Companies Search Parameters

Overview

The SearchParameters object on POST /v2/companies is a dictionary of filters. Each key is a parameter name and each value is an array of one or more filter values.

{
  "SearchParameters": {
    "CountryCode": ["SE"],
    "OperationalStatus": [10],
    "NetSales": [1000000]
  },
  "Currency": "SEK",
  "PageSize": 100
}

Parameter names are case-insensitive. At least one search parameter is required per request.

The tables below list parameters that can be used in company search. Your subscription may restrict which countries and data areas are available. Call GET /v2/companies/search-parameters for the live list, data types, sortable flags, and code dictionaries for your account.

How to Use SearchParameters

Rule	Description
Single value	For numeric filters, one value means a minimum threshold (e.g. `"NetSales": [1000000]` → net sales ≥ 1,000,000).
Two values	Defines an inclusive range (e.g. `"NetSales": [1000000, 5000000]`).
CountryCode	Must be in your authorized country set.
Dates	Use `yyyy-MM-dd` for date/datetime parameters unless noted otherwise. One value = from date; two values = from and to.
Booleans	Use `true` or `false`.
Financial fields	Many financial parameters support a year suffix — see Section 4.

3. Parameter Reference by Category

3.1 Company identity and registration

Parameter	Type	Description
`CountryCode`	String	ISO country code, e.g. `"SE"`, `"NO"`, `"GB"`. Must be authorized for your account.
`Valu8ID`	Int	Valu8 internal company ID.
`CompanyName`	String	Company name (text match).
`OrgNo`	Int	Organisation / registration number.
`VATNumber`	String	VAT identification number.
`ID`	String	Internal / external identifier.
`PreviousNames`	String	Historical company names.
`RegistrationDate`	DateTime	Company registration date.
`UltimateParentOrgNo`	String	Organisation number of the ultimate parent.
`Description`	String	Business description text.
`Address`	String	Registered address (text).
`City`	String	City.
`Zipcode`	Int	Postal / zip code.
`Region`	String	Region or county.
`LFY`	DateTime	Last fiscal year end date.
`NumberOfEmployees`	Double	Number of employees.
`Lists`	String	List membership filter.
`DynamicSearch`	String	Free-text search across company names and descriptions.
`SemanticSearch`	String	AI-powered semantic search over company descriptions.

3.2 Status, legal form, and listing

Parameter	Type	Description
`OperationalStatus`	String	Operational status code. See _v2_companies.md §13.1.
`LegalForm`	String	Legal form code. See _v2_companies.md §13.2.
`CompanyCategory`	String	Role in corporate group hierarchy. See _v2_companies.md §13.3.
`ListingType`	Int	Listing status code.
`HasForeignUltimateParent`	Boolean	Ultimate parent is in a different country.
`HasDescription`	Boolean	Company has a business description.
`HasEmbeddings`	Boolean	Semantic embedding data exists.
`HasShareIssues`	Boolean	Share issue history exists.
`HasComments`	Boolean	Private or shared comments exist.

3.3 Industry and classification

Parameter	Type	Description
`SNIClassification`	String	SNI industry classification (text).
`SNIClassificationCode`	String	SNI classification code.
`GroupSNIClassification`	String	Group-level SNI classification (text).
`GroupSNIClassificationCode`	String	Group-level SNI classification code.
`KeywordCodes`	Int	Keyword / tag code filter.

3.4 Key people, ownership, and governance

Parameter	Type	Description
`Chairman`	String	Chairman name (text search).
`KeyPersons`	String	Key persons (text search).
`BoardMembers`	String	Board members (text search).
`CEOBirthYear`	Int	CEO birth year.
`ChairmanBirthYear`	Int	Chairman birth year.
`MaxOwnershipStakeBirthYear`	Int	Birth year associated with max ownership stake holder.
`Owners`	String	Owner names (text search).
`NumberOfOwners`	Int	Count of owners.
`MaxOwnershipStake`	Double	Maximum ownership stake (%).
`AccountantFirm`	String	Auditor / accountant firm name.
`PrivateEquityOwner`	String	Name of private equity owner.
`HasPrivateEquityOwner`	Boolean	Private equity owner on record.

3.5 Income statement and profitability

Parameter	Type	Description
`NetSales`	Double	Net sales / revenue.
`TotalRevenue`	Double	Total revenue.
`GrossProfit`	Double	Gross profit.
`EBITDA`	Double	Earnings before interest, taxes, depreciation, and amortization.
`EBIT`	Double	Earnings before interest and taxes.
`EBITD`	Double	EBITD.
`EBITA`	Double	EBITA.
`PreTaxProfit`	Double	Profit before tax.
`NetProfit`	Double	Net profit.
`FinancialIncome`	Double	Financial income.
`FinancialExpenses`	Double	Financial expenses.
`NetFinancials`	Double	Net financial result.
`Depreciation`	Double	Depreciation.
`Amortisation`	Double	Amortisation.
`DeprAmo`	Double	Depreciation and amortisation combined.
`RawMaterialsAndConsumables`	Double	Raw materials and consumables (cost).
`NetSalesEstimate`	Double	Estimated net sales.

3.6 Balance sheet

Parameter	Type	Description
`TotalAssets`	Double	Total assets.
`TotalEquity`	Double	Total equity.
`ShareholdEq`	Double	Shareholders' equity.
`ShareCapital`	Double	Share capital.
`CashEquivalents`	Double	Cash and cash equivalents.
`GoodwillIntangAss`	Double	Goodwill and intangible assets.
`PPE`	Double	Property, plant, and equipment.
`Inventories`	Double	Inventories.
`Commodities`	Double	Commodities (balance sheet).
`RawMaterials`	Double	Raw materials (balance sheet).
`AccRec`	Double	Accounts receivable.
`AccPay`	Double	Accounts payable.
`OthCurrOpAss`	Double	Other current operating assets.
`OthNCurrOpAss`	Double	Other non-current operating assets.
`NCurrFinRec`	Double	Non-current financial receivables.
`TotalNonCurrentAssets`	Double	Total non-current assets.
`CurrentAccrualsAndDeferredIncome`	Double	Current accruals and deferred income.
`NonCurrentAccrualsAndDeferred`	Double	Non-current accruals and deferred items.
`ChargesOutstanding`	Double	Outstanding charges.
`TotalCharges`	Double	Total charges.

3.7 Cash flow

Parameter	Type	Description
`CashFlowOperating`	Double	Cash flow from operating activities.
`NetChangeInCash`	Double	Net change in cash.

3.8 Growth, margins, and ratios

Parameter	Type	Description
`NetSalesGrowth`	Double	Net sales growth rate.
`GrossProfitGrowth`	Double	Gross profit growth rate.
`EBITGrowth`	Double	EBIT growth rate.
`EBITDAGrowth`	Double	EBITDA growth rate.
`NetProfitGrowth`	Double	Net profit growth rate.
`EmployeeGrowth`	Double	Employee headcount growth rate.
`GrossProfitMargin`	Double	Gross profit margin.
`EBITMargin`	Double	EBIT margin.
`EBITDAMargin`	Double	EBITDA margin.
`PreTaxProfitMargin`	Double	Pre-tax profit margin.
`NetProfitMargin`	Double	Net profit margin.
`ROE`	Double	Return on equity.
`EquityRatio`	Double	Equity ratio.
`NetDebtToEquity`	Double	Net debt to equity.
`NetDebtToEBITDA`	Double	Net debt to EBITDA.
`NetDebtToEBIT`	Double	Net debt to EBIT.
`EVToNetSales`	Double	Enterprise value to net sales.
`EVToEBITDA`	Double	Enterprise value to EBITDA.
`EVToEBIT`	Double	Enterprise value to EBIT.
`PBV`	Double	Price to book value.
`PE`	Double	Price to earnings.
`RRK`	Double	RRK ratio.
`EPS`	Double	Earnings per share.
`DPS`	Double	Dividends per share.
`Dividends`	Double	Dividends paid.
`NetDebt`	Double	Net debt.
`NetCapex`	Double	Net capital expenditure.

3.9 CAGR and compound growth

Parameter	Type	Description
`CAGR`	Double	Compound annual growth rate.
`CAGR3`	Double	3-year CAGR.
`CAGREBIT`	Double	CAGR (EBIT).
`CAGREBITDA`	Double	CAGR (EBITDA).
`CAGR3EBIT`	Double	3-year CAGR (EBIT).
`CAGR3EBITDA`	Double	3-year CAGR (EBITDA).
`CAGRGrossProfit`	Double	CAGR (gross profit).
`CAGR3GrossProfit`	Double	3-year CAGR (gross profit).
`CAGRNumberOfEmployees`	Double	CAGR (number of employees).
`CAGR3NumberOfEmployees`	Double	3-year CAGR (employees).
`CAGRTotalAssets`	Double	CAGR (total assets).
`CAGR3TotalAssets`	Double	3-year CAGR (total assets).
`CAGRTotalCurrentAssets`	Double	CAGR (total current assets).
`CAGR3TotalCurrentAssets`	Double	3-year CAGR (total current assets).

3.10 Valuation and market

Parameter	Type	Description
`MarketCap`	Double	Market capitalisation.
`EV`	Double	Enterprise value.

3.11 Share issues and capital events

Parameter	Type	Description
`NumberOfShares`	Double	Number of shares.
`LatestSharePrice`	Double	Latest share price.
`LatestShareIssueAmount`	Double	Latest share issue amount.
`LatestShareIssueImpliedValuation`	Double	Implied valuation from latest share issue.
`TotalShareIssueAmount`	Double	Total share issue amount (historical).
`ShareIssuePriceSales`	Double	Share issue price / sales ratio.
`ShareIssuePriceEarnings`	Double	Share issue price / earnings ratio.
`ShareIssuePriceEquity`	Double	Share issue price / equity ratio.
`LastShareIssueDate`	DateTime	Date of most recent share issue.

3.12 LinkedIn and web enrichment

Parameter	Type	Description
`CompanySize`	String	Company size classification.
`Website`	String	Company website URL.
`HasWebPage`	Boolean	Company has a website on record.
`HasLinkedInPage`	Boolean	LinkedIn profile exists.
`LinkedInNumberOfEmployees`	Double	Employee count from LinkedIn.
`LinkedInDescription`	String	Company description from LinkedIn.
`LinkedInSizeRange`	String	Employee size range from LinkedIn.
`LinkedInKeywords`	String	Keywords / specialties from LinkedIn.
`LinkedInClassification`	String	LinkedIn industry classification.
`WebsiteSummary`	String	Website summary text.
`WSBusinessModelType`	String	Website-derived business model type.
`WSCustomerBase`	String	Website-derived customer base.
`WSOwnershipCategory`	String	Website-derived ownership category.

3.13 Comments, similarity, and collaboration

Parameter	Type	Description
`PrivateComments`	String	Private comment text filter.
`SharedComments`	String	Shared comment text filter.
`CompanySimilarity`	String	Find companies similar to a given Valu8 ID (pass the ID as the filter value).

3.14 Data freshness timestamps

Parameter	Type	Description
`ContentUpdatedAt`	DateTime	Broad content update timestamp (`yyyy-MM-dd`).
`RelationsUpdatedAt`	DateTime	Relations update timestamp.
`GeneratedAt`	DateTime	Schema / generation timestamp.
`OwnersUpdatedAt`	DateTime	Ownership update timestamp.
`KeyPeopleUpdatedAt`	DateTime	Key people update timestamp.
`FinancialsUpdatedAt`	DateTime	Financials update timestamp.
`CompanyInfoUpdatedAt`	DateTime	Company registration info update timestamp.
`BeneficialOwnerUpdatedAt`	DateTime	Beneficial owner update timestamp.
`UpdatedDate`	Int	General update indicator (internal encoding).
`FinancialsUpdatedDate`	DateTime	When financials were last updated.
`CompanyInfoUpdatedDate`	DateTime	When company info was last updated.
`StructureUpdatedDate`	DateTime	When corporate structure was last updated.
`OwnersUpdatedDate`	DateTime	When ownership data was last updated.
`KeyPersonsUpdatedDate`	DateTime	When key persons data was last updated.
`DataUpdatedDate`	DateTime	When data was last updated.
`BeneficialOwnerUpdatedDate`	DateTime	When beneficial owner data was last updated.
`EDRUpdatedDate`	DateTime	When EDR (registry) data was last updated.
`WorksitesUpdatedAt`	DateTime	When worksite data was last updated.

4. Financial Year Suffixes

Many Double financial parameters can be scoped to a specific fiscal year by appending _Year_{yyyy} to the parameter name. The base name must match a parameter from Sections 3.5–3.11.

Pattern	Example	Meaning
`{Parameter}`	`"NetSales": [1000000]`	Threshold on the default / latest available year (backend-defined).
`{Parameter}_Year_{yyyy}`	`"NetSales_Year_2023": [1000000]`	Threshold on fiscal year 2023 only.
`{Parameter}_Year_{yyyy}` (two values)	`"EBITDA_Year_2022": [500000, 2000000]`	EBITDA in 2022 within range.

Example:

{
  "SearchParameters": {
    "CountryCode": ["SE"],
    "OperationalStatus": [10],
    "NetSales_Year_2023": [10000000],
    "EBITDAMargin_Year_2023": [0.10, 0.25]
  }
}

Companion Endpoint

Endpoint: GET /v2/companies/search-parameters

Returns the authoritative list of search parameters for your subscription, including:

Parameter names and data types
Which fields are sortable (SortByColumn)
Code dictionaries (e.g. valid OperationalStatus, LegalForm, CountryCode values)
Optional query: SearchParameter to filter the list; DisplayOnlyFieldsWithSearchableCodes to limit to fields with lookup tables