API referenceCompanies
Overview
The register entry itself — name, registered office, purpose, capital, legal form — and everything listed under it: roles, shareholders, holdings, documents, financial statements and the events of one company.
The register entry itself — name, registered office, purpose, capital, legal form — and everything listed under it: roles, shareholders, holdings, documents, financial statements and the events of one company. The KYB report assembles the register entry, roles, shareholders and source filings for one request.
| Endpoint | Route | Cost |
|---|---|---|
| Find companies by asking in words | POST /companies/find | 1 credit per 10 returned results |
| Check a customer's details against the register | POST /companies/verify | 4 credits, plus 8 with ubo |
| Retrieve a company | GET /companies/{company_id} | 10 credits |
| List the roles at a company | GET /companies/{company_id}/roles | 10 credits |
| List a company's register history | GET /companies/{company_id}/events | 10 credits |
| List who holds an interest in a company | GET /companies/{company_id}/shareholders | 10 credits |
| List the companies a company holds interests in | GET /companies/{company_id}/holdings | 10 credits |
| Retrieve the tree of a company's holders | GET /companies/{company_id}/ownership-tree | 10 credits |
| Compute beneficial owners from register filings | GET /companies/{company_id}/beneficial-owners | 25 credits |
| Assemble a KYB report for a company | GET /companies/{company_id}/kyb-report | 50 credits |
| List a company's register documents | GET /companies/{company_id}/documents | 1 credit |
| List a company's financial statements | GET /companies/{company_id}/financial-statements | 10 credits |