Docs

Documentation

Everything you need to integrate CompanyLens into your application or AI agent.

Interactive API Reference

Full interactive docs with try-it support — enter your API key and make live requests directly from the browser.

New to the API? Quick start guide →

Open API Playground →Download Postman Collection Quick start guide

Authentication

All endpoints require an API key in the Authorization header:

Authorization: Bearer cl_live_your_api_key

Get an API key from your dashboard. The free tier includes 500 requests/month — no credit card required.

Base URL

https://api.companylens.io

Endpoints

Companies

GET/v1/companies/searchFuzzy name search with jurisdiction and status filters GET/v1/companies/autocompleteFast typeahead — prefix match with trigram fallback GET/v1/companies/{jurisdiction}/{number}Full company profile — officers and beneficial owners GET/v1/companies/{jurisdiction}/{number}/officersPaginated officer list GET/v1/companies/{jurisdiction}/{number}/beneficial-ownersPaginated beneficial owner (PSC) list GET/v1/companies/{jurisdiction}/{number}/filingsPaginated filing history — confirmation statements, accounts, and regulatory submissions GET/v1/companies/{jurisdiction}/{number}/financialsPaginated financial statementssoon GET/v1/companies/{jurisdiction}/{number}/networkCompanies linked via shared officers or beneficial owners GET/v1/companies/{jurisdiction}/{number}/chargesRegistered charges and mortgages against company assets (GB only)GET/v1/companies/{jurisdiction}/by-addressCompanies registered at the same address — exact match with trigram fallback POST/v1/companies/batchBatch lookup — resolve up to 50 companies by jurisdiction and number in one request

People

GET/v1/people/searchUnified search across officers, PSC, and disqualified directors GET/v1/people/officers/searchOfficer/director search by name GET/v1/people/beneficial-owners/searchBeneficial owner search by name GET/v1/people/disqualified-directors/searchDisqualified director search by name (GB only)GET/v1/people/{jurisdiction}/{id}Unified person profile by jurisdiction and internal UUID GET/v1/people/disqualified-directors/{jurisdiction}/{personId}Full disqualified director profile

Platform

GET/v1/jurisdictionsAvailable jurisdictions with metadata, per-resource availability, and approximate record counts GET/v1/statsPlatform statistics — entity, officer, and beneficial owner counts and last ETL run GET/v1/usageYour current plan, rate limits, and usage per product (api, mcp) for the active billing period GET/v1/healthDatabase connectivity health check

Account

GET/v1/me/keysList all API keys belonging to the authenticated user DELETE/v1/me/keys/{keyId}Deactivate an API key

Quick example

curl "https://api.companylens.io/v1/companies/search?q=apple&jurisdiction=GB&status=active" \
  -H "Authorization: Bearer cl_live_your_api_key"

Pagination

List endpoints accept page and pageSize query parameters (default 20, max 100). Responses include a meta object with total, page, and pageSize.

Rate limits

Tier	Monthly requests	Daily limit
Free	500	50
API Starter	5,000	Unlimited
API Pro	25,000	Unlimited
API Business	100,000	Unlimited

Requests that exceed your limit return 429 Too Many Requests. See pricing for full tier details.

For the full interactive reference with live request testing, open api.companylens.io/docs/swagger.