Skip to main content
Docs

Documentation

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

REST API examples

Practical curl examples for the most common API calls. Replace YOUR_API_KEY with a key from your dashboard. See the authentication guide if you haven't set up an API key yet.

Using an AI agent instead? MCP examples →

Companies

GET

Search companies by name

Fuzzy name search across all jurisdictions. Results are ranked by relevance.

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

Filter by jurisdiction and status

Narrow to a specific country and company status. Use the two-letter jurisdiction code.

/v1/companies/search
curl "https://api.companylens.io/v1/companies/search?q=smith&jurisdiction=gb&status=active" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET

Get a company profile

Retrieve core entity data. Check the supportedSections field to see what detail is available.

/v1/companies/{jurisdiction}/{id}
curl "https://api.companylens.io/v1/companies/gb/08804411" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET

Get company officers

Retrieve the current and historical officer list for a specific company.

/v1/companies/{jurisdiction}/{id}/officers
curl "https://api.companylens.io/v1/companies/gb/08804411/officers" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST

Batch company lookup

Fetch core profiles for up to 20 companies in a single request — useful for bulk enrichment.

/v1/companies/batch
curl -X POST "https://api.companylens.io/v1/companies/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companies": [
      { "jurisdiction": "gb", "number": "08804411" },
      { "jurisdiction": "ie", "number": "123456" }
    ]
  }'

People

GET

Search officers and beneficial owners

Cross-jurisdiction name search over officer and PSC records.

/v1/people/search
curl "https://api.companylens.io/v1/people/search?q=john+smith" \
  -H "Authorization: Bearer YOUR_API_KEY"

Networks

GET

Get corporate network

Find entities connected through shared officers or beneficial owners, up to 2 hops.

/v1/companies/{jurisdiction}/{id}/network
curl "https://api.companylens.io/v1/companies/gb/08804411/network" \
  -H "Authorization: Bearer YOUR_API_KEY"

Account

GET

Check API usage

Returns your current plan, rate limits, and query count for the active billing period.

/v1/usage
curl "https://api.companylens.io/v1/usage" \
  -H "Authorization: Bearer YOUR_API_KEY"

Full API reference

Every endpoint with request parameters, response schema, and error codes is documented in the API reference →