Search - TIC

The TIC LENS search API is built on Typesense, a lightning-fast search engine that stores its index in RAM. This makes it ideal for search-as-you-type, autocomplete, geo-search, and other latency-sensitive applications. All features described in the Typesense API (v29) are available through our proxy endpoints.

Collections

Collection	Endpoint	Minimum plan
Companies	`/search-public/companies`	Pro+
Persons	`/search-public/persons`	Enterprise+
Workplaces	`/search-public/workplaces`	Max+
Vehicles	`/search-public/vehicles`	Pro+
Properties	`/search-public/properties`	Max+
Bankruptcies	`/search-public/bankruptcies`	Max+
Financial reports	`/search-public/reports`	Enterprise+

Parameters

Parameter	Type	Description
`q`	string	The search query. Use `*` to match all documents.
`query_by`	string	Comma-separated list of fields to search in.
`filter_by`	string	Filter expression (see Typesense filter docs).
`sort_by`	string	Comma-separated list of fields to sort by.
`per_page`	int	Number of results per page (max 50; persons max 5).
`page`	int	Page number (1-based).

POST is recommended for complex queries. GET is convenient for quick lookups and search-as-you-type.

Search by name

GET
POST

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/companies?q=Volvo&query_by=names.nameOrIdentifier"

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": "Volvo",
    "query_by": "names.nameOrIdentifier",
    "per_page": 10,
    "page": 1
  }'

Search by registration number

GET
POST

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/companies?q=5565199493&query_by=registrationNumber"

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": "5565199493",
    "query_by": "registrationNumber",
    "per_page": 5,
    "page": 1
  }'

Search by phone number (E.164)

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/companies?q=+46850565800&query_by=phoneNumbers.e164PhoneNumber"

Geo-search within a radius

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/companies?q=*&query_by=mostRecentRegisteredAddress.streetAddress&filter_by=mostRecentRegisteredAddress.location:(57.6799,12.09162,0.300 km)&sort_by=mostRecentRegisteredAddress.location(57.6799,12.09162):asc"

Read more in the Typesense geo-search docs.

Filter by companyId

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/companies?q=*&query_by=registrationNumber&filter_by=companyId:[3508351]"

Search by SNI industry code

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/companies?q=45111&query_by=sniCodes.sni_2007Code"

Stock-listed companies

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/companies?q=OMX+Stockholm&query_by=stock.marketExchangeName"

Intelligence records

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/companies?q=*&query_by=registrationNumber&filter_by=intelligence.companyIntelligenceSubType:['MISSING_AUDITOR']%26%26intelligence.score:>254"

POST with complex filters

POST lets you send structured search requests in JSON with complex filter expressions:

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",
    "filter_by": "mostRecentFinancialSummary.fn_NumberOfEmployees:>100 && mostRecentRegisteredAddress.city:Stockholm",
    "sort_by": "mostRecentFinancialSummary.rs_NetSalesK:desc",
    "per_page": 20,
    "page": 1
  }'

Pro tier filtering

On the Pro plan, company search automatically excludes certain legal entity types and ceased companies. Max and Enterprise plans have unfiltered access to all records.

Redacted properties

Depending on your plan, certain properties may be excluded from search results. The response includes a redacted array listing the omitted fields:

{
  "redacted": ["mostRecentDebtorSummary", "currentBeneficialOwners"]
}

Date handling

All date fields are in Unix epoch seconds (seconds since 1970-01-01 00:00:00 UTC). Companies registered before 1970 will have negative values. Typesense only supports Unix timestamps.

SNI codes — 2007 and 2025

Since December 2024, Statistics Sweden (SCB) has been migrating from SNI 2007 to SNI 2025. We recommend searching on both sniCodes.sni_2007Code and sniCodes.sni_2025Code during the transition. Search results include both code systems.

Intelligence types

Intelligence records flag discrepancies found in company data. Each record has a score between 0 (informational) and 255 (severe). When filtering by intelligence.companyIntelligenceType, use the numeric value:

Value	Type	Description
0	`CreatedAsShelfCompany`	Company was created as a shelf company
1	`SuspectedForQuickLiquidation`	Suspected quick liquidation
3	`AffiliatedWithArticle`	Affiliated with one or more articles
5	`SuspectedAddress`	Address has been flagged
7	`PresentOnWarningList`	Present on certain warning lists
8	`AnnualReportDiscrepancies`	Annual report contains discrepancies
9	`AuditorResignation`	Auditor has resigned
10	`Registration`	Issues with registration
11	`RegisterChanges`	Registry change triggered a policy
12	`PenaltyFees`	Penalized by a fee
13	`BeneficialOwner`	Issues with beneficial owner registration
14	`Claims`	Claims from government agencies

Intelligence subtypes

Filter by intelligence.companyIntelligenceSubType using the string value:

Subtype	Description
`BS_MISMATCH`	Balance sheet doesn’t balance
`AGM_TO_LATE`	Annual general meeting held too late
`AR_TO_LATE`	Annual report submitted too late
`MISSING_AUDITOR`	Missing required auditor
`LIQUIDATION_REQUIRED`	Subject to liquidation requirements
`F_TAX_REVOKED`	F-tax registration revoked
`AUDITOR_DISCOURGES`	Auditor discourages the balance/result sheet
`AUDITOR_ACCOUNTING_ISSUES`	Auditor mentions accounting issues
`AUDITOR_EARLY_RESIGNATION`	Auditor made an early resignation
`NEGATIVE_SHARECAPITAL`	Negative share capital in balance sheet
`FORBIDDEN_LOAN`	Management report mentions a forbidden loan

See the full list of subtypes in the API reference.

Category fields

Fields starting with c (e.g. cTurnoverInterval, cNbrEmployeesInterval) are statistical category fields compiled weekly by Statistics Sweden across all legal entity types. Each contains:

categoryCode — numeric code
categoryCodeDescription — human-readable description

These are useful for filtering across company types that don’t submit annual reports.

Identifiers Pagination

​Collections

​Parameters

​Search by name

​Search by registration number

​Search by phone number (E.164)

​Geo-search within a radius

​Filter by companyId

​Search by SNI industry code

​Stock-listed companies

​Intelligence records

​POST with complex filters

​Pro tier filtering

​Redacted properties

​Date handling

​SNI codes — 2007 and 2025

​Intelligence types

​Intelligence subtypes

​Category fields