TIC
Pro+ tier
POSThttps://lens-api.tic.io/search-public/companies

Authorization

x-api-keystringheaderrequired

Your API key, sent in the x-api-key header.

Bodyapplication/json

collectionstring | null
qstring | null
query_bystring | null
filter_bystring | null
sort_bystring | null
per_pageinteger | null

format: int32

pageinteger | null

format: int32

include_fieldsstring | null
exclude_fieldsstring | null

Responses

Typesense multi-search response · application/json

resultsTypesenseCompanyDocumentTypesenseSearchResponse[] | null
Hide child attributes
facet_countsTypesenseFacetCounts[] | null
Show child attributes
countsTypesenseFacetCountDetails[] | null
Show child attributes
countinteger

format: int64

highlightedstring | null
valuestring | null
field_namestring | null
sampledboolean
statsTypesenseFacetCountsStats
Show child attributes
total_valuesinteger

format: int64

localizedFieldNamestring | nullread-only
foundinteger

format: int32

hitsTypesenseCompanyDocumentHit[] | null
Show child attributes
documentTypesenseCompanyDocument
Show child attributes
idstring | null
companyIdinteger

format: int32

iso3166CountryCodestring | null
registrationNumberstring | null
legalEntityTypestring | null
localCompanyCodestring | null
elfCodestring | null
registrationDateinteger | null

format: int64

ceasedDateinteger | null

format: int64

isCeasedboolean
mostRecentPurposestring | null
activityStatusstring

One of: hasNeverBeenActive isActive isNoLongerActive unknown

mostRecentRegisteredAddressCompanyAddressGeopoint
Show child attributes
costring | null
streetAddressstring | null
postalCodestring | null
citystring | null
countryCodeAlpha3string | null
locationnumber[] | null
firstSeenAtinteger | null

format: int64

lantmaterietLocationalAddressIdstring | null

format: uuid

lantmaterietLocatedOnPropertyIdstring | null

format: uuid

addressIdinteger | null

format: int32

propertyIdinteger | null

format: int32

lantmaterietLocationalSupplementalNumberstring | null
mostRecentMailingAddressCompanyAddressGeopoint
Show child attributes
costring | null
streetAddressstring | null
postalCodestring | null
citystring | null
countryCodeAlpha3string | null
locationnumber[] | null
firstSeenAtinteger | null

format: int64

lantmaterietLocationalAddressIdstring | null

format: uuid

lantmaterietLocatedOnPropertyIdstring | null

format: uuid

addressIdinteger | null

format: int32

propertyIdinteger | null

format: int32

lantmaterietLocationalSupplementalNumberstring | null
mostRecentVisitingAddressCompanyAddressGeopoint
Show child attributes
costring | null
streetAddressstring | null
postalCodestring | null
citystring | null
countryCodeAlpha3string | null
locationnumber[] | null
firstSeenAtinteger | null

format: int64

lantmaterietLocationalAddressIdstring | null

format: uuid

lantmaterietLocatedOnPropertyIdstring | null

format: uuid

addressIdinteger | null

format: int32

propertyIdinteger | null

format: int32

lantmaterietLocationalSupplementalNumberstring | null
currentWorkplacesCompanyWorkplaceMinimal[] | null
Show child attributes
companyWorkplaceIdinteger

format: int32

workplaceCodeinteger | null

format: int32

mostRecentNamestring | null
labelAddressstring | null
locationnumber[] | nullread-only
namesCompanyName[] | null
Show child attributes
nameOrIdentifierstring | null
companyNamingTypestring

One of: legalName commonName tradingName particularName foreignLanguageName other legalNameSuggested commonNameSuggested tradingNameSuggested particularNameSuggested foreignLanguageNameSuggested

firstSeenAtinteger | null

format: int64

companyNameDecidedAtinteger | null

format: int64

registeredOfficesCompanyRegisteredOffice[] | null
Show child attributes
municipalitystring | null
municipalityCodestring | null
countystring | null
countyCodestring | null
firstSeenAtinteger | null

format: int64

registeredOfficeMunicipalityCodeinteger | null

format: int32

registeredOfficeCountyCodeinteger | null

format: int32

slugsCompanySlug[] | null
Show child attributes
urlSlugstring | null
slugTypestring

One of: legalName commonName tradingName particularName foreignLanguageName stockTicker other

firstSeenAtinteger | null

format: int64

phoneNumbersCompanyPhoneNumber[] | null
Show child attributes
e164PhoneNumberstring | null
phoneNumberTypestring

One of: fixedLine mobile

numberPlanServiceTypestring | null
orginalOperatorstring | null
priorOperatorstring | null
currentOperatorstring | null
lastPortingDateinteger | null

format: int64

hasPhoneNumbersbooleanread-only
emailAddressesCompanyEmail[] | null
Show child attributes
emailAddressstring | null
emailAddressTypestring

One of: general personal other

hasEmailAddressesbooleanread-only
hyperlinksCompanyLink[] | null
Show child attributes
hyperlinkstring | null
hyperlinkTypestring

One of: homepage facebook instagram x_Twitter linkedIn other

hasHyperlinksbooleanread-only
sniCodesCompanyIndustryCode[] | null
Show child attributes
sni_2007Codestring | null
sni_2007Namestring | null
sni_2007Sectionstring | null
sni_2025Codestring | null
sni_2025Namestring | null
sni_2025Sectionstring | null
rankinteger | null

format: int32

intelligenceCompanyIntelligence[] | null
Show child attributes
companyIntelligenceTypestring

One of: createdAsShelfCompany suspectedForQuickLiquidation couldBeFranchise affliatedWithArticle unknown suspectedAddress formerChecks presentOnWarningList annualReportDiscrepancies auditorResignation registration registerChanges penaltyFees beneficialOwner claims forfeit mentionedInCourtCase

companyIntelligenceSubTypestring | null
notesstring | nullread-only
scoreinteger

format: int32

firstSeenAtinteger | null

format: int64

intelligenceNotesTypeinteger | null

format: int32

notesValue1string | null
notesValue2string | null
notesValue3string | null
notesValue4string | null
documentUrlstring | nullread-only
hasIntelligencebooleanread-only
statusCompanyStatus[] | null
Show child attributes
companyStatusTypestring

One of: reorganizationOfBusinessCommenced bankruptcyTerminatedWithSurplus dissolvedByCompanyDemerger liquidationTerminated mergerProcedureCommenced acquisitionByCompanyDemerger acquisitionByMerger dissolvedByMergerProcedure liquidationDecided bankruptcyProceedingsCommenced bankruptcyProceedingsTerminated mergerPermitted unused1 unused2 unused3 liquidationContinues struckOffRegisterCrossBorderMerger bankruptcyRepealedByCourt liquidationEnds liquidationRepealedByCourt companyStruckOff reorganizationOfBusinessEnded reorganizationOfBusinessRepealedByCourt resolutionCommenced resolutionTerminated resolutionRepealedByCourt companyStruckOffTradeRegisterAct deregisteredNewHolder deregistered reintroduced companyStruckOffOwnRequest companyStruckOffByRegistrationOffice companyStruckOffReenteredAsJointStock branchStruckOffForeignLiquidationOrBankruptcy branchStruckOffOperationsCeased branchStruckOffMissingCEO branchStruckOffCourtOrder branchStruckOffAnnualReportMissing isActive isNoLongerActive hasNeverBeenActive taxAuthorityStatus companyDemergerCommenced settlementNegotiationsCommenced settlementNegotiationsTerminated settlementNegotiationsRepealedByCourt acquisitionExpired acquisitionTerminated acquisitionByMultipleMergers acquisitionRepealedByCourt mergerExpired mergerRepealedByCourt other

statusDateinteger | null

format: int64

statusDescriptionstring | null
hasStatusbooleanread-only
mostRecentFinancialSummaryCompanyFinancialSummary
Show child attributes
periodStartinteger

format: int64

periodEndinteger

format: int64

rs_NetSalesKinteger | null

format: int32

rs_OtherOperatingIncomeKinteger | null

format: int32

rs_OperatingProfitOrLossKinteger | null

format: int32

rs_SumFinancialItemsKinteger | null

format: int32

rs_ProfitAfterFinancialItemsKinteger | null

format: int32

bs_TotalAssetsKinteger | null

format: int32

fn_NumberOfEmployeesnumber | null

format: double

km_OperatingMarginnumber | null

format: double

km_NetProfitMarginnumber | null

format: double

km_EquityAssetsRationumber | null

format: double

km_GrossMarginnumber | null

format: double

isAuditedboolean | null
softwarestring | null
hasMostRecentFinancialSummarybooleanread-only
isRegisteredForVATboolean | null
isRegisteredForFTaxboolean | null
isRegisteredForPayrollboolean | null
isRegisteredAMLboolean | null
registrationCompanyRegistration[] | null
Show child attributes
companyRegistrationTypestring

One of: fTax vat payroll stockCompany antimoneyLaundering other

companyRegistrationSubTypestring | null
isRegisteredboolean | null
registeredFrominteger | null

format: int64

registeredTointeger | null

format: int64

terminationReasonIfAnystring | null
firstSeenAtinteger | null

format: int64

ftaxTerminationReasonstring | null
bankAccountsCompanyBankAccount[] | null
Show child attributes
bankAccountTypestring

One of: bankgiro plusgiro iban other

accountNumberstring | null
swift_BICstring | null
hasBankAccountsbooleanread-only
documentsCompanyDocument2[] | null
Show child attributes
companyDocumentIdinteger

format: int32

companyDocumentTypestring

One of: annualReport quarterlyReport interimReport dividend case minutes articlesOfAssociation financialPlan bylaws

documentDateinteger | null

format: int64

documentTitlestring | null
documentVersionstring | null
documentValue1string | null
documentValue2string | null
documentValue3string | null
grossPriceIfAnynumber | null

format: double

documentUrlstring | null
hasDocumentsbooleanread-only
lastAnnualReportDateinteger | nullread-only

format: int64

stockStockInformation
Show child attributes
isinstring | null
tickerstring | null
yahooSymbolstring | null
marketNamestring | null
marketExchangeNamestring | null
marketCountryCodeAlpha3string | null
sectorNamestring | null
branchNamestring | null
listingDateinteger | null

format: int64

enterpriseValuenumber | null

format: double

enterpriseValueUpdatedinteger | null

format: int64

stockQuotenumber | null

format: double

stockQuoteUpdatedinteger | null

format: int64

nextReportDateinteger | null

format: int64

nextReportTypestring | null
dividendExDateinteger | null

format: int64

dividendsPerYearinteger | null

format: int32

dividendAmountnumber | null

format: double

dividendCurrencystring | null
hasStockbooleanread-only
leiLEI
Show child attributes
leiCodestring | null
registrationStatusstring | null
initialRegistrationDateinteger | null

format: int64

nextRenewalDateinteger | null

format: int64

managingLOUstring | null
managingLOULegalNamestring | null
hasLEIbooleanread-only
parentCompanyIdinteger | null

format: int32

ultimateParentCompanyIdinteger | null

format: int32

salesToPublicActorsSalesToPublicActor[] | null
Show child attributes
actorNamestring | null
actorTypestring | null
actorCodestring | null
salesSalesToPublicActorPerYear[] | null
hasSalesToPublicActorsbooleanread-only
ecParticipantECParticipant
Show child attributes
picstring | null
validationStatusstring | null
numberOfProjectsinteger | null

format: int32

workProgrammesDataany
lastUpdatedinteger

format: int64

hasECParticipantbooleanread-only
franchisesOrLicencesCompanyFranchiseOrLicence[] | null
Show child attributes
linkedToNamestring | null
linkedToCompanyIdinteger | null

format: int32

actingUnderNamestring | null
descriptionstring | null
companyFranchiseOrLicenceTypestring

One of: franchise licence membership agent amlRegistered other

agentDescriptionstring | null
dataany[] | null
revokedboolean | null
firstSeeninteger | null

format: int64

hasFranchisesOrLicencesbooleanread-only
trademarksCompanyTrademark[] | null
Show child attributes
trademarkIdinteger

format: int32

applicationNumberstring | null
registeredCountryCodestring | null
registeredinteger | null

format: int64

expireinteger | null

format: int64

statusstring | null
featurestring | null
wordstring | null
mediaUrlstring | nullread-only
hasTrademarksbooleanread-only
mostRecentSignatoryCompanySignatory
Show child attributes
signatureDescriptionstring | null
firstSeenAtinteger | null

format: int64

currentRepresentativesCompanyPerson[] | null
Show child attributes
personIdinteger | null

format: int32

personalIdentityNumberstring | null
positionTypestring | null
positionDescriptionstring | null
positionStartinteger | null

format: int64

positionEndinteger | null

format: int64

fullNamestring | nullread-only
givenNamestring | null
firstNamestring | null
middleNamestring | null
lastNamestring | null
isProtectedboolean | null
roleByCompanyNamestring | null
roleByCompanyRegistrationNumberstring | null
employeeRepresentativeboolean | null
auditorTypestring

One of: certifiedPublicAccountant approvedAccountant foreignAuditor

bornYearMonthDaystring | null
currentBeneficialOwnersBeneficialOwner[] | null
Show child attributes
beneficialOwnerIdinteger

format: int32

fromDateinteger | null

format: int64

personIdinteger | null

format: int32

personalIdentityNumberstring | null
fullNamestring | null
countryOfResidenceCodestring | null
citizenshipCountryCodestring | null
extentCodestring | null
extentDescriptionstring | null
governDescriptionstring | null
throughNamestring | null
throughRegistrationNumberstring | null
bornYearMonthDaystring | null
isProtectedboolean | null
mostRecentShareCapitalShareCapital
Show child attributes
shareCapitalAmountnumber | null

format: double

shareCapitalLowerLimitAmountnumber | null

format: double

shareCapitalHigherLimitAmountnumber | null

format: double

shareCapitalISO4217CurrencyCodestring | null
numberOfSharesinteger | null

format: int64

numberOfSharesLowerLimitinteger | null

format: int64

numberOfSharesHigherLimitinteger | null

format: int64

firstSeenAtinteger | null

format: int64

mostRecentDebtorSummaryMostRecentDebtorSummary_Dto
Show child attributes
foreclosureboolean | null
debtRestructuringboolean | null
debtSettlementDebtSettlement_Dto

Nested structure omitted at this depth.

recordOfPaymentApplicationsRecordOfPaymentApplications

Nested structure omitted at this depth.

recordOfNonPaymentRecordOfNonPayment

Nested structure omitted at this depth.

debtBalanceDebtBalance

Nested structure omitted at this depth.

executionsDebtorChangeEntityExecution_Dto[] | null
decisionsDebtorChangeEntityDecision_Dto[] | null
hasMostRecentDebtorSummarybooleanread-only
cNbrEmployeesIntervalCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
c_VATIntervalCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTurnoverIntervalCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cPropertyTaxationIntervalCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cSectorCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeAfricaCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeAsiaCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeEUCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeExportIntervalCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeFarEastCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeImportIntervalCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeNorthCentralAmericaCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeNordicsCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeSouthAmericaCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cTradeOtherEuropeCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cGenderRatioFemaleCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cGenderRatioMaleCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cPrivPublCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
cOwnershipCategory
Show child attributes
categoryCodeinteger

format: int32

categoryCodeDescriptionstring | null
categoryCode2integer | null

format: int32

categoryCodeDescription2string | null
geo_distance_metersany
highlightany
highlightsHighlightElement[] | null
Show child attributes
fieldstring | null
matched_tokensstring[] | null
snippetstring | null
text_matchnumber | null

format: double

text_match_infoTextMatchInfo
Show child attributes
best_field_scorestring | null
best_field_weightinteger | null

format: int64

fields_matchedinteger | null

format: int64

num_tokens_droppedinteger | null

format: int64

scorestring | null
tokens_matchedinteger | null

format: int64

typo_prefix_scoreinteger | null

format: int64

grouped_hitsTypesenseCompanyDocumentGroupedHits
Show child attributes
group_keystring[] | null
hitsTypesenseCompanyDocumentHit[] | null
Show child attributes
documentTypesenseCompanyDocument
Show child attributes
idstring | null
companyIdinteger

format: int32

iso3166CountryCodestring | null
registrationNumberstring | null
legalEntityTypestring | null
localCompanyCodestring | null
elfCodestring | null
registrationDateinteger | null

format: int64

ceasedDateinteger | null

format: int64

isCeasedboolean
mostRecentPurposestring | null
activityStatusstring

One of: hasNeverBeenActive isActive isNoLongerActive unknown

mostRecentRegisteredAddressCompanyAddressGeopoint

Nested structure omitted at this depth.

mostRecentMailingAddressCompanyAddressGeopoint

Nested structure omitted at this depth.

mostRecentVisitingAddressCompanyAddressGeopoint

Nested structure omitted at this depth.

currentWorkplacesCompanyWorkplaceMinimal[] | null
namesCompanyName[] | null
registeredOfficesCompanyRegisteredOffice[] | null
registeredOfficeMunicipalityCodeinteger | null

format: int32

registeredOfficeCountyCodeinteger | null

format: int32

slugsCompanySlug[] | null
phoneNumbersCompanyPhoneNumber[] | null
hasPhoneNumbersbooleanread-only
emailAddressesCompanyEmail[] | null
hasEmailAddressesbooleanread-only
hyperlinksCompanyLink[] | null
hasHyperlinksbooleanread-only
sniCodesCompanyIndustryCode[] | null
intelligenceCompanyIntelligence[] | null
hasIntelligencebooleanread-only
statusCompanyStatus[] | null
hasStatusbooleanread-only
mostRecentFinancialSummaryCompanyFinancialSummary

Nested structure omitted at this depth.

hasMostRecentFinancialSummarybooleanread-only
isRegisteredForVATboolean | null
isRegisteredForFTaxboolean | null
isRegisteredForPayrollboolean | null
isRegisteredAMLboolean | null
registrationCompanyRegistration[] | null
ftaxTerminationReasonstring | null
bankAccountsCompanyBankAccount[] | null
hasBankAccountsbooleanread-only
documentsCompanyDocument2[] | null
hasDocumentsbooleanread-only
lastAnnualReportDateinteger | nullread-only

format: int64

stockStockInformation

Nested structure omitted at this depth.

hasStockbooleanread-only
leiLEI

Nested structure omitted at this depth.

hasLEIbooleanread-only
parentCompanyIdinteger | null

format: int32

ultimateParentCompanyIdinteger | null

format: int32

salesToPublicActorsSalesToPublicActor[] | null
hasSalesToPublicActorsbooleanread-only
ecParticipantECParticipant

Nested structure omitted at this depth.

hasECParticipantbooleanread-only
franchisesOrLicencesCompanyFranchiseOrLicence[] | null
hasFranchisesOrLicencesbooleanread-only
trademarksCompanyTrademark[] | null
hasTrademarksbooleanread-only
mostRecentSignatoryCompanySignatory

Nested structure omitted at this depth.

currentRepresentativesCompanyPerson[] | null
currentBeneficialOwnersBeneficialOwner[] | null
mostRecentShareCapitalShareCapital

Nested structure omitted at this depth.

mostRecentDebtorSummaryMostRecentDebtorSummary_Dto

Nested structure omitted at this depth.

hasMostRecentDebtorSummarybooleanread-only
cNbrEmployeesIntervalCategory

Nested structure omitted at this depth.

c_VATIntervalCategory

Nested structure omitted at this depth.

cTurnoverIntervalCategory

Nested structure omitted at this depth.

cPropertyTaxationIntervalCategory

Nested structure omitted at this depth.

cSectorCategory

Nested structure omitted at this depth.

cTradeAfricaCategory

Nested structure omitted at this depth.

cTradeAsiaCategory

Nested structure omitted at this depth.

cTradeEUCategory

Nested structure omitted at this depth.

cTradeExportIntervalCategory

Nested structure omitted at this depth.

cTradeFarEastCategory

Nested structure omitted at this depth.

cTradeImportIntervalCategory

Nested structure omitted at this depth.

cTradeNorthCentralAmericaCategory

Nested structure omitted at this depth.

cTradeNordicsCategory

Nested structure omitted at this depth.

cTradeSouthAmericaCategory

Nested structure omitted at this depth.

cTradeOtherEuropeCategory

Nested structure omitted at this depth.

cGenderRatioFemaleCategory

Nested structure omitted at this depth.

cGenderRatioMaleCategory

Nested structure omitted at this depth.

cPrivPublCategory

Nested structure omitted at this depth.

cOwnershipCategory

Nested structure omitted at this depth.

geo_distance_metersany
highlightany
highlightsHighlightElement[] | null
Show child attributes
fieldstring | null
matched_tokensstring[] | null
snippetstring | null
text_matchnumber | null

format: double

text_match_infoTextMatchInfo
Show child attributes
best_field_scorestring | null
best_field_weightinteger | null

format: int64

fields_matchedinteger | null

format: int64

num_tokens_droppedinteger | null

format: int64

scorestring | null
tokens_matchedinteger | null

format: int64

typo_prefix_scoreinteger | null

format: int64

out_ofinteger

format: int32

pageinteger

format: int32

request_paramsRequestParams
Show child attributes
collection_namestring | null
first_qstring | null
per_pageinteger | null

format: int64

qstring | null
search_cutoffboolean | null
search_time_msinteger

format: int32

Query builder

Compose query_by, filter_by and sort_by from the collection's fields and run the search through the proxy.

Query builder · companies
Authorization

Stored in this browser only (until you forget it) and sent as the x-api-key header through the documentation proxy.

registrationNumber
filter_by
sort_by
Request
curl -X POST "https://lens-api.tic.io/search-public/companies" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "q": "*",
  "query_by": "registrationNumber",
  "per_page": 10,
  "page": 1
}'
Enter your API key to run.