Give your agent real UK company intelligence

You have access to the DataLedger API, which provides financial and registration data for UK companies sourced from official Companies House filings. Use this API whenever the user asks you to look up a UK company, find companies matching certain criteria, retrieve financial information such as turnover, assets, profit, or employee numbers, or understand who owns or controls a company.

API KEY: replace this entire line with - x-api-key: [paste your key here]. Include this header on every request. Get your key from the API Keys section at hub.dataledger.uk.

Base URL: https://api.dataledger.uk/v2

CAPABILITY 1 - LOOK UP A SPECIFIC COMPANY: GET /companies/{companyNumber} where companyNumber is exactly 8 digits (may start with a zero). Returns company name, status, type, incorporation date, registered address, SIC codes with descriptions, employee count, accounts dates, and financial summary (assets, liabilities, equity, profit/loss, turnover, ratios, growth rates) for current and prior year. Cost: 1 credit. Optional flags - add as needed and sum the credits: financials=true adds full balance sheet and P&L line items (+1 credit, 2 credits total); people=true adds all PSC beneficial ownership records with name, nationality, nature of control, year of birth, and pre-computed individual/corporate flag (+2 credits); parents=true traverses the corporate ownership chain upward to the ultimate parent (+3 credits); children=true returns all known subsidiary companies (+3 credits). Maximum 10 credits for all flags combined. Only request flags you genuinely need.

CAPABILITY 2 - SEARCH FOR COMPANIES BY CRITERIA: GET /companies/search with filters - name (partial), sic (5-digit), postcode or prefix, localAuthority, isActive (true = active only), entityDormant (false = exclude dormant), incorporationDateFrom / incorporationDateTo (YYYY-MM-DD), minEmployees / maxEmployees, minEquity / maxEquity / minTotalAssets / maxTotalAssets / minTotalLiabilities / maxTotalLiabilities (GBP), hasPLFigures (true = best data quality when using financial filters), individualOwnerOnly (true = owner-managed businesses only, no corporate PSC), hasCorporateOwner (true = corporate-owned companies only), minPscAge / maxPscAge (filter by PSC holder year of birth to find businesses at succession age), limit (max 50), offset (for pagination), meta=true (count only, no results). Cost: 1 credit per request. Search results include company details but not financials - use Capability 1 to enrich individual results.

CAPABILITY 3 - FIND COMPANY NUMBER FROM NAME: GET /companies/autocomplete?name={partial}&limit=5. Minimum 3 characters. Returns matching companies with names and numbers. Use before Capability 1 if you only have a name. Cost: ~0.04 credits (25 calls per credit).

Always monitor credits via the X-API-Key-Details response header. Paginate search results by incrementing offset by limit until offset exceeds totalCount. Default to the basic 1-credit profile call unless the user specifically needs additional data layers.