PublicSearch
Search companies (POST)
Multi-search body equivalent of the GET endpoint, on the companies collection. per_page is capped at 50. Pro tier: certain legal entity types and ceased companies are filtered out server-side. Max/Enterprise: unfiltered.
Pro+ tier
POSThttps://lens-api.tic.io/search-public/companies
Authorization
x-api-keystringheaderrequiredYour API key, sent in the x-api-key header.
Bodyapplication/json
collectionstring | nullqstring | nullquery_bystring | nullfilter_bystring | nullsort_bystring | nullper_pageinteger | nullpageinteger | nullinclude_fieldsstring | nullexclude_fieldsstring | nullResponses
Typesense multi-search response · application/json
resultsTypesenseCompanyDocumentTypesenseSearchResponse[] | nullHide child attributes
facet_countsTypesenseFacetCounts[] | nullShow child attributes
countsTypesenseFacetCountDetails[] | nullShow child attributes
countintegerhighlightedstring | nullvaluestring | nullfield_namestring | nullsampledbooleanstatsTypesenseFacetCountsStatsShow child attributes
total_valuesintegerlocalizedFieldNamestring | nullread-onlyfoundintegerhitsTypesenseCompanyDocumentHit[] | nullShow child attributes
documentTypesenseCompanyDocumentShow child attributes
idstring | nullcompanyIdintegeriso3166CountryCodestring | nullregistrationNumberstring | nulllegalEntityTypestring | nulllocalCompanyCodestring | nullelfCodestring | nullregistrationDateinteger | nullceasedDateinteger | nullisCeasedbooleanmostRecentPurposestring | nullactivityStatusstringmostRecentRegisteredAddressCompanyAddressGeopointShow child attributes
costring | nullstreetAddressstring | nullpostalCodestring | nullcitystring | nullcountryCodeAlpha3string | nulllocationnumber[] | nullfirstSeenAtinteger | nulllantmaterietLocationalAddressIdstring | nulllantmaterietLocatedOnPropertyIdstring | nulladdressIdinteger | nullpropertyIdinteger | nulllantmaterietLocationalSupplementalNumberstring | nullmostRecentMailingAddressCompanyAddressGeopointShow child attributes
costring | nullstreetAddressstring | nullpostalCodestring | nullcitystring | nullcountryCodeAlpha3string | nulllocationnumber[] | nullfirstSeenAtinteger | nulllantmaterietLocationalAddressIdstring | nulllantmaterietLocatedOnPropertyIdstring | nulladdressIdinteger | nullpropertyIdinteger | nulllantmaterietLocationalSupplementalNumberstring | nullmostRecentVisitingAddressCompanyAddressGeopointShow child attributes
costring | nullstreetAddressstring | nullpostalCodestring | nullcitystring | nullcountryCodeAlpha3string | nulllocationnumber[] | nullfirstSeenAtinteger | nulllantmaterietLocationalAddressIdstring | nulllantmaterietLocatedOnPropertyIdstring | nulladdressIdinteger | nullpropertyIdinteger | nulllantmaterietLocationalSupplementalNumberstring | nullcurrentWorkplacesCompanyWorkplaceMinimal[] | nullShow child attributes
companyWorkplaceIdintegerworkplaceCodeinteger | nullmostRecentNamestring | nulllabelAddressstring | nulllocationnumber[] | nullread-onlynamesCompanyName[] | nullShow child attributes
nameOrIdentifierstring | nullcompanyNamingTypestringfirstSeenAtinteger | nullcompanyNameDecidedAtinteger | nullregisteredOfficesCompanyRegisteredOffice[] | nullShow child attributes
municipalitystring | nullmunicipalityCodestring | nullcountystring | nullcountyCodestring | nullfirstSeenAtinteger | nullregisteredOfficeMunicipalityCodeinteger | nullregisteredOfficeCountyCodeinteger | nullslugsCompanySlug[] | nullShow child attributes
urlSlugstring | nullslugTypestringfirstSeenAtinteger | nullphoneNumbersCompanyPhoneNumber[] | nullShow child attributes
e164PhoneNumberstring | nullphoneNumberTypestringnumberPlanServiceTypestring | nullorginalOperatorstring | nullpriorOperatorstring | nullcurrentOperatorstring | nulllastPortingDateinteger | nullhasPhoneNumbersbooleanread-onlyemailAddressesCompanyEmail[] | nullShow child attributes
emailAddressstring | nullemailAddressTypestringhasEmailAddressesbooleanread-onlyhyperlinksCompanyLink[] | nullShow child attributes
hyperlinkstring | nullhyperlinkTypestringhasHyperlinksbooleanread-onlysniCodesCompanyIndustryCode[] | nullShow child attributes
sni_2007Codestring | nullsni_2007Namestring | nullsni_2007Sectionstring | nullsni_2025Codestring | nullsni_2025Namestring | nullsni_2025Sectionstring | nullrankinteger | nullintelligenceCompanyIntelligence[] | nullShow child attributes
companyIntelligenceTypestringcompanyIntelligenceSubTypestring | nullnotesstring | nullread-onlyscoreintegerfirstSeenAtinteger | nullintelligenceNotesTypeinteger | nullnotesValue1string | nullnotesValue2string | nullnotesValue3string | nullnotesValue4string | nulldocumentUrlstring | nullread-onlyhasIntelligencebooleanread-onlystatusCompanyStatus[] | nullShow child attributes
companyStatusTypestringstatusDateinteger | nullstatusDescriptionstring | nullhasStatusbooleanread-onlymostRecentFinancialSummaryCompanyFinancialSummaryShow child attributes
periodStartintegerperiodEndintegerrs_NetSalesKinteger | nullrs_OtherOperatingIncomeKinteger | nullrs_OperatingProfitOrLossKinteger | nullrs_SumFinancialItemsKinteger | nullrs_ProfitAfterFinancialItemsKinteger | nullbs_TotalAssetsKinteger | nullfn_NumberOfEmployeesnumber | nullkm_OperatingMarginnumber | nullkm_NetProfitMarginnumber | nullkm_EquityAssetsRationumber | nullkm_GrossMarginnumber | nullisAuditedboolean | nullsoftwarestring | nullhasMostRecentFinancialSummarybooleanread-onlyisRegisteredForVATboolean | nullisRegisteredForFTaxboolean | nullisRegisteredForPayrollboolean | nullisRegisteredAMLboolean | nullregistrationCompanyRegistration[] | nullShow child attributes
companyRegistrationTypestringcompanyRegistrationSubTypestring | nullisRegisteredboolean | nullregisteredFrominteger | nullregisteredTointeger | nullterminationReasonIfAnystring | nullfirstSeenAtinteger | nullftaxTerminationReasonstring | nullbankAccountsCompanyBankAccount[] | nullShow child attributes
bankAccountTypestringaccountNumberstring | nullswift_BICstring | nullhasBankAccountsbooleanread-onlydocumentsCompanyDocument2[] | nullShow child attributes
companyDocumentIdintegercompanyDocumentTypestringdocumentDateinteger | nulldocumentTitlestring | nulldocumentVersionstring | nulldocumentValue1string | nulldocumentValue2string | nulldocumentValue3string | nullgrossPriceIfAnynumber | nulldocumentUrlstring | nullhasDocumentsbooleanread-onlylastAnnualReportDateinteger | nullread-onlystockStockInformationShow child attributes
isinstring | nulltickerstring | nullyahooSymbolstring | nullmarketNamestring | nullmarketExchangeNamestring | nullmarketCountryCodeAlpha3string | nullsectorNamestring | nullbranchNamestring | nulllistingDateinteger | nullenterpriseValuenumber | nullenterpriseValueUpdatedinteger | nullstockQuotenumber | nullstockQuoteUpdatedinteger | nullnextReportDateinteger | nullnextReportTypestring | nulldividendExDateinteger | nulldividendsPerYearinteger | nulldividendAmountnumber | nulldividendCurrencystring | nullhasStockbooleanread-onlyleiLEIShow child attributes
leiCodestring | nullregistrationStatusstring | nullinitialRegistrationDateinteger | nullnextRenewalDateinteger | nullmanagingLOUstring | nullmanagingLOULegalNamestring | nullhasLEIbooleanread-onlyparentCompanyIdinteger | nullultimateParentCompanyIdinteger | nullsalesToPublicActorsSalesToPublicActor[] | nullShow child attributes
actorNamestring | nullactorTypestring | nullactorCodestring | nullsalesSalesToPublicActorPerYear[] | nullhasSalesToPublicActorsbooleanread-onlyecParticipantECParticipantShow child attributes
picstring | nullvalidationStatusstring | nullnumberOfProjectsinteger | nullworkProgrammesDataanylastUpdatedintegerhasECParticipantbooleanread-onlyfranchisesOrLicencesCompanyFranchiseOrLicence[] | nullShow child attributes
linkedToNamestring | nulllinkedToCompanyIdinteger | nullactingUnderNamestring | nulldescriptionstring | nullcompanyFranchiseOrLicenceTypestringagentDescriptionstring | nulldataany[] | nullrevokedboolean | nullfirstSeeninteger | nullhasFranchisesOrLicencesbooleanread-onlytrademarksCompanyTrademark[] | nullShow child attributes
trademarkIdintegerapplicationNumberstring | nullregisteredCountryCodestring | nullregisteredinteger | nullexpireinteger | nullstatusstring | nullfeaturestring | nullwordstring | nullmediaUrlstring | nullread-onlyhasTrademarksbooleanread-onlymostRecentSignatoryCompanySignatoryShow child attributes
signatureDescriptionstring | nullfirstSeenAtinteger | nullcurrentRepresentativesCompanyPerson[] | nullShow child attributes
personIdinteger | nullpersonalIdentityNumberstring | nullpositionTypestring | nullpositionDescriptionstring | nullpositionStartinteger | nullpositionEndinteger | nullfullNamestring | nullread-onlygivenNamestring | nullfirstNamestring | nullmiddleNamestring | nulllastNamestring | nullisProtectedboolean | nullroleByCompanyNamestring | nullroleByCompanyRegistrationNumberstring | nullemployeeRepresentativeboolean | nullauditorTypestringbornYearMonthDaystring | nullcurrentBeneficialOwnersBeneficialOwner[] | nullShow child attributes
beneficialOwnerIdintegerfromDateinteger | nullpersonIdinteger | nullpersonalIdentityNumberstring | nullfullNamestring | nullcountryOfResidenceCodestring | nullcitizenshipCountryCodestring | nullextentCodestring | nullextentDescriptionstring | nullgovernDescriptionstring | nullthroughNamestring | nullthroughRegistrationNumberstring | nullbornYearMonthDaystring | nullisProtectedboolean | nullmostRecentShareCapitalShareCapitalShow child attributes
shareCapitalAmountnumber | nullshareCapitalLowerLimitAmountnumber | nullshareCapitalHigherLimitAmountnumber | nullshareCapitalISO4217CurrencyCodestring | nullnumberOfSharesinteger | nullnumberOfSharesLowerLimitinteger | nullnumberOfSharesHigherLimitinteger | nullfirstSeenAtinteger | nullmostRecentDebtorSummaryMostRecentDebtorSummary_DtoShow child attributes
foreclosureboolean | nulldebtRestructuringboolean | nulldebtSettlementDebtSettlement_DtorecordOfPaymentApplicationsRecordOfPaymentApplicationsrecordOfNonPaymentRecordOfNonPaymentdebtBalanceDebtBalanceexecutionsDebtorChangeEntityExecution_Dto[] | nulldecisionsDebtorChangeEntityDecision_Dto[] | nullhasMostRecentDebtorSummarybooleanread-onlycNbrEmployeesIntervalCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullc_VATIntervalCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTurnoverIntervalCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcPropertyTaxationIntervalCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcSectorCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeAfricaCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeAsiaCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeEUCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeExportIntervalCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeFarEastCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeImportIntervalCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeNorthCentralAmericaCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeNordicsCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeSouthAmericaCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcTradeOtherEuropeCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcGenderRatioFemaleCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcGenderRatioMaleCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcPrivPublCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullcOwnershipCategoryShow child attributes
categoryCodeintegercategoryCodeDescriptionstring | nullcategoryCode2integer | nullcategoryCodeDescription2string | nullgeo_distance_metersanyhighlightanyhighlightsHighlightElement[] | nullShow child attributes
fieldstring | nullmatched_tokensstring[] | nullsnippetstring | nulltext_matchnumber | nulltext_match_infoTextMatchInfoShow child attributes
best_field_scorestring | nullbest_field_weightinteger | nullfields_matchedinteger | nullnum_tokens_droppedinteger | nullscorestring | nulltokens_matchedinteger | nulltypo_prefix_scoreinteger | nullgrouped_hitsTypesenseCompanyDocumentGroupedHitsShow child attributes
group_keystring[] | nullhitsTypesenseCompanyDocumentHit[] | nullShow child attributes
documentTypesenseCompanyDocumentShow child attributes
idstring | nullcompanyIdintegeriso3166CountryCodestring | nullregistrationNumberstring | nulllegalEntityTypestring | nulllocalCompanyCodestring | nullelfCodestring | nullregistrationDateinteger | nullceasedDateinteger | nullisCeasedbooleanmostRecentPurposestring | nullactivityStatusstringmostRecentRegisteredAddressCompanyAddressGeopointmostRecentMailingAddressCompanyAddressGeopointmostRecentVisitingAddressCompanyAddressGeopointcurrentWorkplacesCompanyWorkplaceMinimal[] | nullnamesCompanyName[] | nullregisteredOfficesCompanyRegisteredOffice[] | nullregisteredOfficeMunicipalityCodeinteger | nullregisteredOfficeCountyCodeinteger | nullslugsCompanySlug[] | nullphoneNumbersCompanyPhoneNumber[] | nullhasPhoneNumbersbooleanread-onlyemailAddressesCompanyEmail[] | nullhasEmailAddressesbooleanread-onlyhyperlinksCompanyLink[] | nullhasHyperlinksbooleanread-onlysniCodesCompanyIndustryCode[] | nullintelligenceCompanyIntelligence[] | nullhasIntelligencebooleanread-onlystatusCompanyStatus[] | nullhasStatusbooleanread-onlymostRecentFinancialSummaryCompanyFinancialSummaryhasMostRecentFinancialSummarybooleanread-onlyisRegisteredForVATboolean | nullisRegisteredForFTaxboolean | nullisRegisteredForPayrollboolean | nullisRegisteredAMLboolean | nullregistrationCompanyRegistration[] | nullftaxTerminationReasonstring | nullbankAccountsCompanyBankAccount[] | nullhasBankAccountsbooleanread-onlydocumentsCompanyDocument2[] | nullhasDocumentsbooleanread-onlylastAnnualReportDateinteger | nullread-onlystockStockInformationhasStockbooleanread-onlyleiLEIhasLEIbooleanread-onlyparentCompanyIdinteger | nullultimateParentCompanyIdinteger | nullsalesToPublicActorsSalesToPublicActor[] | nullhasSalesToPublicActorsbooleanread-onlyecParticipantECParticipanthasECParticipantbooleanread-onlyfranchisesOrLicencesCompanyFranchiseOrLicence[] | nullhasFranchisesOrLicencesbooleanread-onlytrademarksCompanyTrademark[] | nullhasTrademarksbooleanread-onlymostRecentSignatoryCompanySignatorycurrentRepresentativesCompanyPerson[] | nullcurrentBeneficialOwnersBeneficialOwner[] | nullmostRecentShareCapitalShareCapitalmostRecentDebtorSummaryMostRecentDebtorSummary_DtohasMostRecentDebtorSummarybooleanread-onlycNbrEmployeesIntervalCategoryc_VATIntervalCategorycTurnoverIntervalCategorycPropertyTaxationIntervalCategorycSectorCategorycTradeAfricaCategorycTradeAsiaCategorycTradeEUCategorycTradeExportIntervalCategorycTradeFarEastCategorycTradeImportIntervalCategorycTradeNorthCentralAmericaCategorycTradeNordicsCategorycTradeSouthAmericaCategorycTradeOtherEuropeCategorycGenderRatioFemaleCategorycGenderRatioMaleCategorycPrivPublCategorycOwnershipCategorygeo_distance_metersanyhighlightanyhighlightsHighlightElement[] | nullShow child attributes
fieldstring | nullmatched_tokensstring[] | nullsnippetstring | nulltext_matchnumber | nulltext_match_infoTextMatchInfoShow child attributes
best_field_scorestring | nullbest_field_weightinteger | nullfields_matchedinteger | nullnum_tokens_droppedinteger | nullscorestring | nulltokens_matchedinteger | nulltypo_prefix_scoreinteger | nullout_ofintegerpageintegerrequest_paramsRequestParamsShow child attributes
collection_namestring | nullfirst_qstring | nullper_pageinteger | nullqstring | nullsearch_cutoffboolean | nullsearch_time_msintegerUpstream Typesense error
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.
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.