Skip to main content
Docs

Documentation

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

Available tools

Once connected, your AI agent has access to these tools:

ToolDescription
Search Companiessearch_companiesSearch by name or number across all 18 jurisdictions with typo tolerance and prefix matching
Get Companyget_companyCore company profile — status, address, officer count, and which data sections are available for this jurisdiction
Get Company Sectionget_company_sectionFetch a single section of a company profile: officers or beneficial owners
Get Company Batchget_company_batchFetch core profiles for up to 20 companies in a single call — returns found/not-found per ref
Search Peoplesearch_peopleFind officers, beneficial owners, and disqualified directors by name across all jurisdictions
Get Personget_personPerson identity record — display name and any known name variants matched via date-of-birth
Get Person Sectionget_person_sectionFetch a section of a person profile: company links, officer roles, or disqualification records
Get Company Networkget_company_networkMap the corporate network around a company — graph of connected entities linked via shared officers and owners
Get Person Networkget_person_networkMap the corporate network around a person — all companies they appear in, with depth-2 traversal
Find by Addressfind_by_addressDiscover all companies registered at an address — useful for flagging shared-address clusters and shell company patterns
Get Chargesget_chargesRegistered charges and mortgages against a company — outstanding and satisfied, with persons entitled (UK)
Get Filingsget_filingsPaginated filing history — confirmation statements, annual accounts, share allotments (SH01), PSC changes, and document URLs (UK)
Search Disqualified Directorssearch_disqualified_directorsFuzzy name search over disqualified directors — for KYB name checks and compliance screening
Browse Disqualified Directorsbrowse_disqualified_directorsBrowse all disqualified directors ordered by most recent — for compliance monitoring and bulk review
List Jurisdictionslist_jurisdictionsList all supported jurisdictions with metadata — use to discover valid jurisdiction slugs before calling other tools
List Industry Codeslist_industry_codesList SIC/NACE codes for a jurisdiction, optionally filtered by keyword or code prefix
Get Usageget_usageReturns your current plan, rate limits, and usage for the active billing period