DataLedger API
Programmatic access to structured UK company financial data. Balance sheets, P&L where disclosed, pre-calculated ratios, and company metadata for almost 3 million UK companies with electronic filings - from 5 million+ total records.
No card required · Instant access · Takes 30 seconds
Skip building Companies House infrastructure
Structured, validated financial data through a simple REST API. No parsing XBRL, no data cleaning, no pipeline to maintain.
Real-time access
Query UK company data as new filings are processed. No delays, no batch updates.
Pre-calculated ratios
Debt-to-equity, debt-to-asset, assets growth rate, net assets growth rate - already done for every record.
Structured and verified
Clean JSON responses with quality flags. 2.8 million records carry DataLedger's verification flag.
Advanced filtering
Filter by financial ratios, growth indicators, employee counts, SIC codes, location, and more.
Almost 3M with financials
Almost 3 million UK companies with electronic financial data. 5 million+ total records available for lookup.
Credits roll over
Unused credits from monthly plans roll over every month. One-time purchases never expire.
Up and running in minutes
Three endpoints. Authenticate with x-api-key header on every request.
# Basic profile - 1 credit curl -X GET "https://api.dataledger.uk/v1/companies/12345678" \ -H "x-api-key: YOUR_API_KEY" # Full balance sheet and P&L - 2 credits curl -X GET "https://api.dataledger.uk/v1/companies/12345678?financials=true" \ -H "x-api-key: YOUR_API_KEY"
# Active tech companies in Westminster with assets over £1M - 1 credit curl -X GET "https://api.dataledger.uk/v1/companies/search?isActive=true&sic=62020&localAuthority=Westminster&minTotalAssets=1000000" \ -H "x-api-key: YOUR_API_KEY"
# Resolve partial name to company number - 25 calls = 1 credit curl -X GET "https://api.dataledger.uk/v1/companies/autocomplete?name=acme&limit=5" \ -H "x-api-key: YOUR_API_KEY"
Core API endpoints
Three endpoints covering lookup, search, and autocomplete. Most workflows use all three together.
Resolve a partial company name to a Companies House number. Minimum 3 characters. Ideal for search-as-you-type in forms or lookup tools.
ParametersPartial company name to search for
Number of results to return
Returns array of objects with companyNumber and companyName
Filter for lists of companies. Combine any number of criteria. Use meta=true to get a total count before fetching results. Paginate with limit and offset.
Standard Industrial Classification code e.g. 62020 for IT consultancy
Postcode prefix e.g. SW1, or local authority name e.g. Westminster
Filter by company status
Employee count range
Financial threshold filters
Ratio and growth rate filters. Growth rates as decimals: 0.1 = 10%
Recommended when using financial filters - limits results to companies with P&L data available
Incorporation date range
Pagination
If true, returns only the total count of matching companies - useful for estimating result size before fetching
meta=true first to check result size, then add hasPLFigures=true with financial filters for the best data quality.Retrieve a full company profile by 8-digit Companies House number. Basic profile includes financial summary with totals and ratios. Add financials=true for full balance sheet and P&L line items.
Companies House registration number
false (1 credit): company details plus financial summary - totals, ratios, growth rates.
true (2 credits): adds full balance sheet line items and P&L statement details.
Full documentation with schemas and examples at api.dataledger.uk/docs/v1
Credit-based pricing
Pay for what you use. Credits roll over on monthly plans and never expire on one-time purchases.
Credit usage| Endpoint | Cost |
|---|---|
| Autocomplete | 25 calls = 1 credit |
| Company Search | 1 credit per request |
| Company Profile (basic) | 1 credit per request |
| Company Profile (financials=true) | 2 credits per request |
Pro
Consistent monthly access for regular users. Credits roll over each month.
Commercial
Best value for business users and teams. Credits roll over. Priority support.
100 credits
Testing and small queries.
250 credits
One-off projects.
10,000 credits
£0.0075 per credit.
50,000 credits
£0.006 per credit.
| Plan | Monthly credits | Price | Per credit |
|---|---|---|---|
| Starter API | 10,000 | £75/month | £0.0075 |
| Professional API | 50,000 | £300/month | £0.006 |
| Business API | 200,000 | £1,000/month | £0.005 |
| Enterprise API | 500,000 | £2,000/month | £0.004 |
| Enterprise Unlimited | Unlimited | £4,000/month | - |
Every response includes an X-API-Key-Details header with current usage, limit, credit cost, and reset time. Fair use policy applies to the unlimited plan.
Frequently asked questions
How do API credits work?
Credits are consumed per request based on the endpoint: autocomplete costs 25 calls per credit, search costs 1 credit per request, basic profile costs 1 credit, detailed profile with financials=true costs 2 credits. Monthly plan credits roll over. One-time purchases never expire.
What happens when I run out of credits?
API access stops until you top up or upgrade. Check the X-API-Key-Details header in every response to monitor your remaining credits in real time.
What data is in every API response?
Every company profile includes balance sheet data (assets, liabilities, equity) for current and previous year, company metadata (SIC codes, employees, address, incorporation date), pre-calculated financial ratios, and growth indicators. P&L data is included where the company is required to disclose it. Add financials=true for complete line items.
How do I authenticate?
Use the x-api-key header (lowercase) on every request. Get your key from hub.dataledger.uk.
What is the difference between basic and detailed profiles?
Basic (1 credit): financial summary with totals, pre-calculated ratios, and growth rates. Detailed with financials=true (2 credits): adds full balance sheet line items (intangibles, property, current assets breakdown, creditors, provisions) and full P&L details (turnover, gross profit, operating profit, wages). Default to basic unless you specifically need line items.
Do all companies have turnover data?
No. Most UK SMEs are not required to publish turnover or profit figures. Every company has balance sheet data. Use hasPLFigures=true in search to filter for companies with P&L data available.
Can I use the API for commercial purposes?
Yes. All paid plans include commercial use rights. Use in products, services, internal tools, or as part of your own offerings.
What response format does the API use?
JSON. Consistent field names throughout. Financial prefixes: c = current year, p = previous year. Growth rates returned as decimals (0.1 = 10%).
Is there a free trial?
Yes. Sign up at hub.dataledger.uk and get 25 free credits immediately. No card required. Use them to test all three endpoints and validate your integration.
How often is data updated?
DataLedger processes Companies House filings daily. When you query a company you get the most recent filing available. No batch delays.
What if I need more than 500k credits per month?
The Enterprise Unlimited plan at £4,000/month covers typical usage of 500k-2M credits per month. Contact contact@dataledger.uk for higher volume requirements.
Ready to start building?
Get 25 free credits and start querying UK company data in minutes. No card required.
Supported by
