Skip to main content
Docs

Documentation

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

Every example below works three ways: from the dashboard, via an AI agent (MCP), or through the REST API.

Search companies across all jurisdictions

Fuzzy name search with automatic typo handling. Results span every jurisdiction.

Dashboard

Go to Company Search, type the company name, and results appear instantly across all jurisdictions.

AI Agent (MCP)

"Find all companies named Acme Holdings across all jurisdictions"

REST API
curl "https://api.companylens.io/v1/companies/search?name=acme+holdings" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by jurisdiction and status

Narrow results to a specific country and company status.

Dashboard

Use the Jurisdiction and Status dropdowns on the Company Search page to filter results.

AI Agent (MCP)

"Show me active UK companies with Smith in the name"

REST API
curl "https://api.companylens.io/v1/companies/search?name=smith&jurisdiction=GB&status=active" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get full company detail

Retrieve a company profile including officers and beneficial owners.

Dashboard

Click any company in search results to view the full profile with all related data.

AI Agent (MCP)

"Show me the full details for company number 12345678"

REST API
curl "https://api.companylens.io/v1/companies/12345" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search directors across jurisdictions

Find all officer records matching a name — useful for due diligence and cross-jurisdiction checks.

Dashboard

Go to Person Search and type the director name. Results include officers, beneficial owners, and disqualified directors.

AI Agent (MCP)

"Find all companies where John Smith is a director"

REST API
curl "https://api.companylens.io/v1/officers/search?name=john+smith" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search beneficial owners

Find persons with significant control (PSC) records across jurisdictions.

Dashboard

Person Search includes beneficial owner results alongside officer records.

AI Agent (MCP)

"Find beneficial ownership records for Sarah Wilson"

REST API
curl "https://api.companylens.io/v1/beneficial-owners/search?name=sarah+wilson" \
  -H "Authorization: Bearer YOUR_API_KEY"

Company network — linked entities via shared officers

Discover companies connected through shared directors or officers.

Dashboard

View the Network tab on any company profile to see linked entities.

AI Agent (MCP)

"Show me all companies connected to Acme Holdings through shared directors"

REST API
curl "https://api.companylens.io/v1/companies/12345/network" \
  -H "Authorization: Bearer YOUR_API_KEY"