Company search fields

Pro+ tier These are the fields of the companies search collection behind /search-public/companies (GET, POST). Use them in query_by, filter_by and sort_by. The parameters, plan limits, Pro tier filtering, redacted properties and date handling that apply to every collection are described in Search, and the response schema on the endpoint pages. Field guides for the other collections:

Companies (you are here)
Workplaces
Financial reports
Bankruptcies
Vehicles
Properties

Fields indexed

The following fields are currently indexed in memory. These can be used in the query_by parameter and filter_by. Remember this is not the schema of the JSON response since it contains a large number of additional properties.

Field	Type	Description
companyId	Int32	Our global internal company identifier
registrationNumber	String	The local registration number in the country
legalEntityType	String	Type of legal entity as described in local market
localCompanyCode	String	The local company code as known by the market (for example Aktiebolag = AB)
elfCode	String	ISO Standard 20275 Entity Legal Form (ELF)
registrationDate (unix epoch)	Int64	Unix time (epoch) seconds since 1st January 1970
ceasedDate (unix epoch)	Int64	Unix time (epoch) seconds since 1st January 1970, when the company ceased to exist (note date may be unknown by the flag isCeased will be set)
isCeased	Bool	A flag indicating the business have ceased
mostRecentPurpose	String	The last purpose registered for the business
names.nameOrIdentifier	String	Current and former names of the business (could be legalname, particularName etc)
isRegisteredForVAT	Bool	If the business is registered for VAT
isRegisteredForFTax	Bool	If the business is registered for F-tax
isRegisteredForPayroll	Bool	If the business is registered for payroll
ftaxTerminationReason	String	If the termination of F-tax is known a description
phoneNumbers.e164PhoneNumber	String	E164 formatted phone number
phoneNumbers.numberPlanServiceType	String	Service type as described in local number plan
phoneNumbers.orginalOperator	String	The original operator that held the number
phoneNumbers.priorOperator	String	Last prior operator before the porting
phoneNumbers.currentOperator	String	Current operator
phoneNumbers.lastPortingDate	Int64	Last porting date in Unix time (epoch) seconds since 1st January 1970
emailAddresses.emailAddress	String	E-mail addresses to the business
hyperlinks.hyperlink	String	Hyperlinks to the business
sniCodes.sni_2007Name	String	SNI 2007 name
sniCodes.sni_2007Code	String	SNI 2007 code
sniCodes.sni_2007Section	String	SNI 2007 section
sniCodes.sni_2025Name	String	SNI 2007 name
sniCodes.sni_2025Code	String	SNI 2007 code
sniCodes.sni_2025Section	String	SNI 2025 section
sniCodes.rank	String	SNI 2007/2025 order
bankAccounts.accountNumber	String	Bank accounts
mostRecentRegisteredAddress.co	String	C/O = care of address
mostRecentRegisteredAddress.streetAddress	String	Street address
mostRecentRegisteredAddress.postalCode	String	The postalcode
mostRecentRegisteredAddress.city	String	City
mostRecentRegisteredAddress.countryCodeAlpha3	String	Country code 3 char alpha
mostRecentRegisteredAddress.location	GeoPoint	Allows geosearch
mostRecentMailingAddress.co	String	C/O = care of address
mostRecentMailingAddress.streetAddress	String	Street address
mostRecentMailingAddress.postalCode	String	The postalcode
mostRecentMailingAddress.city	String	City
mostRecentMailingAddress.countryCodeAlpha3	String	Country code 3 char alpha
mostRecentMailingAddress.location	GeoPoint	Allows geosearch
mostRecentVisitingAddress.co	String	C/O = care of address
mostRecentVisitingAddress.streetAddress	String	Street address
mostRecentVisitingAddress.postalCode	String	The postalcode
mostRecentVisitingAddress.city	String	City
mostRecentVisitingAddress.countryCodeAlpha3	String	Country code 3 char alpha
mostRecentVistingAddress.location	GeoPoint	Allows geosearch
registeredOffices.municipality	String	The registered office municipality (säte)
registeredOffices.municipalityCode	String	The registered office municipality code (säte)
registeredOffices.county	String	The registered office county (säte)
registeredOffices.countyCode	String	The registered office county code (säte)
documents.documentTitle	String	Title of the document
documents.documentVersion	String	Version of the document
documents.documentValue3	String	Used to provide additional data about the document
intelligence.companyIntelligenceType	String	The specific enum (int) that you want to query by
intelligence.companyIntelligenceSubType	String	A text enum describing the sub-type of the intelligence type (see documentation)
intelligence.notes	String	The description of the discrepancy
intelligence.score	Int32	A score rank between 0-255 where 0 means only for information and 255 is a serious mark
intelligence.externalId	Int32	A reference for the intelligence type used to find the associated underlying document
mostRecentFinancialSummary.annualReportPeriod	Int32	The endpoint report of the annual report in YYYYMM as Int32
mostRecentFinancialSummary.periodStart	Int64	Start period epoch seconds
mostRecentFinancialSummary.periodEnd	Int64	End period epoch seconds
mostRecentFinancialSummary.rs_NetSalesK	Int32	Net sales in K (thousands)
mostRecentFinancialSummary.rs_OtherOperatingIncomeK	Int32	Other operating income in K (thousands)
mostRecentFinancialSummary.rs_OperatingProfitOrLossK	Int32	Operating profit or loss in K (thousands)
mostRecentFinancialSummary.rs_SumFinancialItemsK	Int32	Sum of financial items in K (thousands)
mostRecentFinancialSummary.rs_ProfitAfterFinancialItemsK	Int32	Profit after financial items in K (thousands)
mostRecentFinancialSummary.bs_TotalAssetsK	Int32	Total assets in balance sheet in K (thouands)
mostRecentFinancialSummary.fn_NumberOfEmployees	Float	Number of employees with one decimal
mostRecentFinancialSummary.km_OperatingMargin	Float	Operating margin with four decimals
mostRecentFinancialSummary.km_NetProfitMargin	Float	Net profit margin with four decimals
mostRecentFinancialSummary.km_EquityAssetsRatio	Float	Equity asset ratio with four decimals
mostRecentFinancialSummary.km_GrossMargin	Float	Gross margin with four decimals
mostRecentFinancialSummary.software	String	Software used to generate the financial report (if known)
mostRecentSignatory.signatureDescription	String	Description of the signature rights
currentRepresentatives.personId	Int32	An internal id representing the person which makes it simpler to query
mostRecentDebtorSummary.debtBalance.totalAmountInSEK	Float	Holds the total amount, currency SEK, out outstanding debts of public- vs. private debt cases in Sweden
mostRecentDebtorSummary.debtBalance.public.description	String	The public case debt type and creditor
mostRecentDebtorSummary.debtBalance.public.numberOfCases	Int32	Number of public debt cases relating to public debt
mostRecentDebtorSummary.debtBalance.public.totalAmountInSEK	Float	Total amount outstanding debt for public debt cases
mostRecentDebtorSummary.debtBalance.private.numberOfCases	Int32	Number of private debt cases relating to public debt
mostRecentDebtorSummary.debtBalance.private.totalAmountInSEK	Float	Total amount private debt for public debt cases
currentRepresentatives.personalIdentityNumber	String	The local market personal identity number
currentRepresentatives.positionType	String	The position of the representative
currentRepresentatives.positionDescription	String	Text description of the position
currentRepresentatives.fullName	String	Fullname of the person
currentRepresentatives.roleByCompanyName	String	If the position is held by a company
currentRepresentatives.roleByCompanyRegistrationNumber	String	If the position is held by a company
currentRepresentatives.auditorType	String	Auditor type
currentRepresentatives.bornYearMonthDay	String	For foreign persons
currentBeneficialOwners.personId	Int32	An internal id representing the person which makes it simpler to query
currentBeneficialOwners.personalIdentityNumber	String	The local market personal identity number
currentBeneficialOwners.fullName	String	Fullname of the person
currentBeneficialOwners.countryOfResidenceCode	String	ISO3166 Country code 2-char
currentBeneficialOwners.citizenshipCountryCode	String	ISO3166 Country code 2-char
currentBeneficialOwners.extentDescription	String	Description of the extent
currentBeneficialOwners.governDescription	String	Description of the govern
currentBeneficialOwners.throughName	String	If managed through a name / company
currentBeneficialOwners.throughRegistrationNumber	String	If managed through a name / company
currentBeneficialOwners.bornYearMonthDay	String	For foreign persons
mostRecentSignatory.signatureDescription	String	The signature description
mostRecentShareCapital.shareCapitalAmount	Float	The current share capital amount
franchisesOrLicences.linkedToName	String	From which company name is the franchise, licence or permit given
franchisesOrLicences.actingUnderName	String	Under which name is the business providing services or sales of goods
franchisesOrLicences.linkedToCompanyId	Int32	From which company id is the franchise, licence or permit given
franchisesOrLicences.description	String	Description of the franchise, licence or permit given
franchisesOrLicences.companyFranchiseOrLicenceType	String	Type of franchise, licence or permit (franchise, licence, membership, agent, other)
currentWorkplaces.companyWorkplaceId	Int32	Our worldwide identifier for the workplace
currentWorkplaces.workplaceCode	Int32	A code for the workplace
currentWorkplaces.mostRecentName	Int32	The name of workplace
currentWorkplaces.labelAddress	String	A label containing the street address, postalcode and city
currentWorkplaces.location	GeoPoint	Allows geosearch
trademarks.word	String	The word representing a word-trademark
trademarks.expire	Int64	When the trademark expire in Unix time (epoch) seconds since 1st January 1970
stock.isin	String	ISIN
stock.ticker	String	Ticker symbol on market
stock.marketName	String	Market name
stock.marketExchangeName	String	Market exchange name
stock.sectorName	String	Business sector as provided on market
stock.branchName	String	Business branch as provided on market
stock.enterpriseValue	String	Enterprise value last closing day
stock.nextReportDate	String	Next report date for the listed company
stock.dividendExDate	String	Next X-date to receive the dividend
stock.yahooSymbol	String	The Yahoo finance symbol
lei.leiCode	String	LEI Code
lei.registrationStatus	String	RETIRED, DUPLICATE, LAPSED, ANNULLED, PENDING_TRANSFER, ISSUED, PENDING_ARCHIVAL
lei.initialRegistrationDate	Int64	Initial registration date in Unix time (epoch) seconds since 1st January 1970
lei.nextRenewalDate	Int64	Initial registration date in Unix time (epoch) seconds since 1st January 1970
lei.managingLOU	String	LEI of the managing LOU
lei.managingLOULegalName	String	Legal name of the LOU
ecParticipant.pic	String	Participant Identification Code (PIC) as registered with European Commission
ecParticipant.validationStatus	String	Declared, Validated, Sleeping, Suspended, Blocked, Deprecated (see further documentation)
ecParticipant.numberOfProjects	Int32	Number of projects where the organization has been present with the PIC
franchisesOrLicences.linkedToName	String	The name of the licencee or company providing the franchise
franchisesOrLicences.actingUnderName	String	The name/s under which the company is acting under
franchisesOrLicences.linkedToCompanyId	Int32	The company id if exists for which the licence or franchise was given
salesToPublicActors.actorName	String	The name of the public actor
salesToPublicActors.actorType	String	The name of the public actor
salesToPublicActors.actorCode	String	The code of the actor, e.g municipality = municipality code
hasSalesToPublicActors	Bool	Helper flag for knowing if the company has sold to public actors
hasPhoneNumbers	Bool	Helper flag for knowing if the company has phone numbers present
hasEmailAddresses	Bool	Helper flag for knowing if the company has email addresses present
hasHyperlinks	Bool	Helper flag for knowing if the company has hyperlinks present
hasIntelligence	Bool	Helper flag for knowing if the company has intelligence records present
hasStatus	Bool	Helper flag for knowing if the company has status records present
hasBankAccounts	Bool	Helper flag for knowing if the company has bank accounts present
hasAddresses	Bool	Helper flag for knowing if the company has addresses present
hasDocuments	Bool	Helper flag for knowing if the company has documents present
hasStock	Bool	Helper flag for knowing if the company has stock data present
hasLEI	Bool	Helper flag for knowing if the company has LEI information present
hasECParticipant	Bool	Helper flag for knowing if the company has EU participant information present
hasFranchisesOrLicences	Bool	Helper flag for knowing if the company has franchises or licences present
hasTrademarks	Bool	Helper flag for knowing if the company has trademarks
hasMostRecentDebtorSummary	Bool	Helper flag for knowing if the company has summary of debts
cNbrEmployeesInterval.categoryCode	Int32	The code for the employee interval
cNbrEmployeesInterval.categoryCodeDescription	String	Description of the interval
cVATInterval.categoryCode	Int32	The code representing the VAT reporting
cVATInterval.categoryCodeDescription	String	Description of the interval
cTurnoverInterval.categoryCode	Int32	The code for the turnover interval
cTurnoverInterval.categoryCodeDescription	String	Description of the interval
cPropertyTaxationInterval.categoryCode	Int32	The code for the employee interval
cPropertyTaxationInterval.categoryCodeDescription	String	Description of the interval
cSector.categoryCode	Int32	The code for the sector
cSector.categoryCodeDescription	String	Description of the sector
cTradeAfrica.categoryCode	Int32	A code (0 or 1) representing if the company is exporting/importing from the continent.
cTradeAfrica.categoryCodeDescription	String	Description of the interval
cTradeAsia.categoryCode	Int32	A code (0 or 1) representing if the company is exporting/importing from the continent.
cTradeAsia.categoryCodeDescription	String	Description of the interval
cTradeEU.categoryCode	Int32	A code (0 or 1) representing if the company is exporting/importing from the continent.
cTradeEU.categoryCodeDescription	String	Description of the interval
cTradeFarEast.categoryCode	Int32	A code (0 or 1) representing if the company is exporting/importing from the continent.
cTradeFarEast.categoryCodeDescription	String	Description of the interval
cTradeNorthCentralAmerica.categoryCode	Int32	A code (0 or 1) representing if the company is exporting/importing from the continent.
cTradeNorthCentralAmerica.categoryCodeDescription	String	Description of the interval
cTradeNordics.categoryCode	Int32	A code (0 or 1) representing if the company is exporting/importing from the continent.
cTradeNordics.categoryCodeDescription	String	Description of the interval
cTradeSouthAmerica.categoryCode	Int32	A code (0 or 1) representing if the company is exporting/importing from the continent.
cTradeSouthAmerica.categoryCodeDescription	String	Description of the interval
cTradeOtherEurope.categoryCode	Int32	A code (0 or 1) representing if the company is exporting/importing from the continent.
cTradeOtherEurope.categoryCodeDescription	String	Description of the interval
cTradeExportInterval.categoryCode	Int32	A code representing the export interval
cTradeExportInterval.categoryCodeDescription	String	Description of the interval
cTradeImportInterval.categoryCode	Int32	A code representing the import interval
cTradeImportInterval.categoryCodeDescription	String	Description of the interval
cGenderRatioFemale.categoryCode	Int32	Gender ratio females in percentage (no fraction)
cGenderRatioFemale.categoryCodeDescription	String	Gender ratio females with percentage sign
cPrivPubl.categoryCode	Int32	Code representing if the company is private/public/listed etc
cPrivPubl.categoryCodeDescription	String	Description of the type of company
cOwnership.categoryCode	Int32	Code representing the kind of ownership
cOwnership.categoryCodeDescription	String	Description of ownership type

European Commission participant status

ecParticipant.validationStatus can contain the following statuses: Declared Organisation registered by self-registrant. Will remain in this status if the validation is done decentrally by the National Agency. Validated Organisation validated centrally by REA (Research Executive Agency). Suspended The legal entity is “frozen” because of an external reason (Bankruptcy, etc.) as a result of central validation by REA (Research Executive Agency). Sleeping Some data was passed, but the contact person does not react on any demands from the REA (Research Executive Agency) validation team. Deprecated When duplication is identified by REA (Research Executive Agency), the validity will be Deprecated and the master PIC will be associated. Will not be published in the search. Blocked Blocked during the validation process by REA (Research Executive Agency).

About the LENS API

Addresses

Bolagsverket

BRF

Companies

Persons

Properties

Vehicles

FlightImages

Public Search

Serving Permits

Sentinel

Screening

Watchlist

Documents

Orders

Order Exports

Payment Control

Payment Control Import

Search Autocomplete

Team

Teams

Free

Company search fields

Fields indexed

European Commission participant status

​Fields indexed

​European Commission participant status

Fields indexed

European Commission participant status