Interactive API Reference
Full interactive docs with try-it support — enter your API key and make live requests directly from the browser.
Authentication
All endpoints require an API key in the Authorization header:
Authorization: Bearer cl_live_your_api_keyGet an API key from your dashboard. The free tier includes 500 requests/month — no credit card required.
Base URL
https://api.companylens.ioEndpoints
Companies
GET
/api/v1/companies/searchFuzzy name search with jurisdiction and status filtersGET
/api/v1/companies/autocompleteFast typeahead — prefix match with trigram fallbackGET
/api/v1/companies/{id}Full company profile — officers and beneficial ownersGET
/api/v1/companies/{id}/officersPaginated officer listGET
/api/v1/companies/{id}/beneficial-ownersPaginated beneficial owner (PSC) listGET
/api/v1/companies/{id}/networkCompanies linked via shared officersGET
/api/v1/companies/{id}/chargesRegistered charges (mortgages)People
GET
/api/v1/people/searchUnified search across officers, PSC, and disqualified directorsGET
/api/v1/people/officers/searchOfficer/director search by nameGET
/api/v1/people/beneficial-owners/searchBeneficial owner search by nameGET
/api/v1/people/disqualified-directors/searchDisqualified director search by nameGET
/api/v1/people/{jurisdiction}/{id}Full officer or beneficial owner profileGET
/api/v1/people/disqualified-directors/{jurisdiction}/{personId}Full disqualified director profileQuick example
curl "https://api.companylens.io/api/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.