Introduction
Programmatic access to the same intelligence platform that powers TIC Lens — covering companies, persons, properties, vehicles, and public procurement.
Data is gathered and processed continuously. The search index is stored in RAM, making the API suitable for search-as-you-type, autocomplete, and other latency-sensitive integrations.
What you can do
Search
Search millions of records — companies, persons, workplaces, vehicles, properties, bankruptcies, and financial reports via a Typesense-powered search engine.
Filter & Sort
Filter and sort on 200+ fields — financial summaries, addresses, representatives, beneficial owners, intelligence records, SNI codes, and more.
Geo-search
Find companies and workplaces within a geographic radius of any coordinate.
Monitor
Query AI-generated risk signals and discrepancy records across annual reports, auditor remarks, and registry changes.
Base URL
| Environment | URL |
|---|---|
| Production | https://lens-api.tic.io |
Quick start
Create an API key from Settings → API Keys in the TIC Lens web application.
curl -H "x-api-key: YOUR_API_KEY" \
"https://lens-api.tic.io/search-public/companies?q=Volvo&query_by=names.nameOrIdentifier&per_page=5"
Read the Search guide for GET and POST examples across all collections, then check out Pagination for list endpoints.
Response format
All responses are JSON. Null values are omitted from responses.
Plan tiers
Endpoints are gated by your subscription plan. Tier badges on each endpoint in the API Reference indicate the minimum required plan:
| Badge | Minimum plan |
|---|---|
| Pro+ | Pro and above |
| Max+ | Max and above |
| Enterprise+ | Enterprise |
| Government+ | Government |
If your plan does not include the required feature, the endpoint returns 403 Forbidden with the missing feature name. See Authentication for the full error reference.
Guides
Authentication
API key setup, scopes, brute-force protection, and error codes.
Rate Limits
IP and per-key limits, response headers, and best practices.
IP Restrictions
Allowed countries and abuse detection.
Search
GET and POST search across all collections with examples.
Pagination & Filtering
Offset-based pagination, sorting, and server-side filtering.
Identifiers
How companyId, personId, UUIDs, and registration numbers connect.
Watchlists
Create watchlists, add members, subscribe to events, and set up notifications.
Support
For questions or to request access from a non-supported country, contact support@tic.io.