DataLedger API

RESTful API providing programmatic access to structured UK company financial data. Access balance sheets, P&L data (where disclosed), pre-calculated ratios, and company metadata for 5+ million UK companies.

Start Free Trial - 25 Credits

No card required • Instant access • Takes 30 seconds

Why Use the DataLedger API?

Skip months of building Companies House infrastructure. Get structured, validated financial data through a simple REST API.

⚡

Real-Time Access

Query UK company data as new filings are processed. No delays, no batch updates.

📊

Pre-Calculated Ratios

Financial ratios and growth indicators already calculated. No need to build your own calculation engine.

🔍

Structured & Validated

Clean JSON responses with data quality flags. Balance sheet validation already done.

🎯

Advanced Filtering

Filter by financial ratios, growth indicators, employee counts, SIC codes, and more.

💾

3.5M+ Companies

Complete coverage of electronically-filed UK company accounts with balance sheet data for all.

🔄

Credit Rollover

Unused credits roll over monthly. Never lose credits you've paid for.

Quick Start

Get up and running in minutes with simple REST endpoints.

Example: Get Company Profile

# Get basic company profile with financial summary
curl -X GET "https://api.dataledger.uk/v1/companies/12345678" \
  -H "x-api-key: YOUR_API_KEY"

Example: Search Companies by Criteria

# Search for active tech companies in Westminster with assets > £1M
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"

Example: Autocomplete for Search-as-You-Type

# Get company name suggestions (25 calls = 1 credit)
curl -X GET "https://api.dataledger.uk/v1/companies/autocomplete?name=tech&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

Core API Endpoints

Three essential endpoints for discovering and analysing UK companies.

GET /v1/companies/autocomplete 25 calls = 1 credit

Return a short list of companies based on partial name match. Perfect for implementing search-as-you-type functionality in your application.

Query Parameters

name string (required, min 3 characters)

Partial company name to search for

limit integer (optional, default 10, max 50)

Number of results to return

Returns

Array of objects with companyNumber and companyName

GET /v1/companies/search 1 credit per request

Search for companies using comprehensive filters. Combine multiple filters to narrow results. Use meta=true to get result count without fetching full data.

Key Filter Parameters (all optional - combine as needed)

meta boolean (default: false)

If true, returns only total count of matching companies instead of full results. Useful for estimating result size before fetching data.

limit / offset integer (limit max 500)

Pagination parameters

name string

Partial match on company name

sic string (5 digits)

Standard Industrial Classification code (e.g., "62020" for IT consultancy)

postcode / localAuthority string

Filter by location (postcode prefix like "SW1" or local authority like "Westminster")

isActive / entityDormant boolean

Filter by company status

min/maxEmployees integer

Filter by employee count range

min/maxTotalAssets number

Filter by total assets in GBP

min/maxEquity number

Filter by equity in GBP

min/maxTotalLiabilities number

Filter by liabilities in GBP

min/maxDebtToEquityRatio number

Filter by debt-to-equity ratio

min/maxAssetsGrowthRate number (as decimal)

Filter by year-on-year asset growth rate (0.1 = 10% growth)

hasPLFigures boolean

Filter for companies with P&L statements (higher data quality). Recommended when using financial filters.

isElectronicSubmission boolean

Filter for companies with electronic submissions (recommended for data quality)

incorporationDateFrom / incorporationDateTo string (YYYY-MM-DD)

Filter by incorporation date range

Pro Tips

• Use meta=true first to estimate result size before fetching full data
• Combine hasPLFigures=true with financial filters for better data quality
• Use pagination for large result sets (max 500 per request)

GET /v1/companies/{companyNumber} 1 credit (basic) | 2 credits (detailed)

Retrieve company profile with configurable levels of financial detail. Basic profile includes financial summary. Add ?financials=true for complete balance sheet and P&L line items.

Path Parameters

companyNumber string (required, 8 digits)

Companies House registration number (e.g., "12345678")

Query Parameters

financials boolean (optional, default: false)

false (1 credit): Returns company details with financial summary (totals and ratios only)
true (2 credits): Returns complete financial statements with all balance sheet line items

Response Includes

Always included: Company registration details, industry classification (SIC codes), registered address, incorporation date, employee count, financial summary with calculated ratios and growth metrics

When financials=true: Complete balance sheet line items (intangible assets, property/plant/equipment, current assets breakdown, liabilities breakdown) and full P&L statement details (turnover, gross profit, operating profit, wages/salaries)

Full API documentation with detailed schemas and examples:
View Interactive API Docs →

API Pricing

Transparent credit-based pricing optimised for developers. Credits work for all API endpoints.

Credit Usage

Autocomplete: 25 calls = 1 credit
Company Search: 1 credit per request
Company Profile (basic): 1 credit per request
Company Profile (detailed): 2 credits per request

Credit Packages

Pro Plan

£10/month
300 credits per month

Perfect for regular platform users with consistent API needs.

  • 300 monthly credits
  • Credits roll over
  • Full API access
  • Email support
MOST POPULAR

Commercial Plan

£20/month
2,000 credits per month

Best value for business users and teams with ongoing data needs.

  • 2,000 monthly credits
  • Credits roll over
  • Full API access
  • Priority support

One-Time Credit Purchases

Starter

£5
100 credits

Perfect for testing and small queries.

  • One-time purchase
  • Full API access

Pro

£10
250 credits

Good for one-off projects.

  • One-time purchase
  • Full API access

10,000 Credits

£75
10,000 credits • £0.0075 per credit

For medium-scale data needs.

  • One-time purchase
  • Full API access

50,000 Credits

£300
50,000 credits • £0.006 per credit

For large-scale projects.

  • One-time purchase
  • Full API access

High-Volume Monthly Plans

Plan Monthly Credits Price Cost per Credit
Starter API 10,000 credits £75/month £0.0075
Professional API 50,000 credits £300/month £0.006
Business API 200,000 credits £1,000/month £0.005
Enterprise API 500,000 credits £2,000/month £0.004
Enterprise Unlimited Unlimited £4,000/month —

Usage Tracking: Every response includes an X-API-Key-Details header showing your current usage, limit, credit cost, and reset time.

Fair use policy applies to unlimited plan (typical usage 500k-2M credits/month)

Frequently Asked Questions

How do API credits work?

Credits are consumed based on the endpoint and complexity: Autocomplete costs 25 calls per 1 credit (optimised for search-as-you-type), Company Search costs 1 credit per request, basic Company Profile costs 1 credit, and detailed Company Profile (with financials=true) costs 2 credits. Unused credits from monthly plans roll over. One-time credit purchases never expire.

What happens if I exceed my credit limit?

If you exceed your credit limit, API access stops until you upgrade your plan or purchase additional credits. Check the X-API-Key-Details header in every response to track your usage.

Do unused credits roll over?

Yes! Unused credits from monthly subscriptions roll over each month. One-time credit purchases never expire. You don't lose credits you've paid for.

What data is included in API responses?

Every company includes: balance sheet data (assets, liabilities, equity) for current and previous year, company metadata (SIC codes, employees, address), pre-calculated financial ratios, growth indicators, and P&L data where disclosed. When you request detailed financials (financials=true), you get complete balance sheet line items and P&L statement details.

How do I authenticate API requests?

Use the x-api-key header (lowercase) for authentication. Include your API key in every request: x-api-key: YOUR_API_KEY. Get your API key from your account dashboard at hub.dataledger.uk.

What's the difference between basic and detailed company profiles?

Basic profile (1 credit): Returns company details with financial summary - calculated totals (assets, liabilities, equity), pre-calculated ratios (debt-to-equity, debt-to-asset), and growth rates. Detailed profile (2 credits, financials=true): Returns everything in basic plus complete balance sheet line items (intangible assets, property/plant/equipment, current assets breakdown, creditors, provisions) and full P&L statement details (turnover, gross profit, operating profit, wages/salaries).

How does the autocomplete endpoint work?

The autocomplete endpoint is optimised for search-as-you-type functionality with cost-effective pricing: 25 calls = 1 credit. It requires minimum 3 characters and returns simple objects with company number and name. Perfect for implementing company search features without expensive per-call costs.

Can I filter companies by financial criteria?

Yes! The /v1/companies/search endpoint supports extensive filtering: SIC codes, employee ranges, asset levels, equity thresholds, liabilities, turnover (where disclosed), debt ratios, growth rates, profitability, postcodes, local authorities, incorporation dates, and more. Combine multiple filters to build precise prospect lists. Use meta=true to get result counts before fetching full data.

Do all companies have turnover data?

No. Most UK SMEs (micro-entities and small companies) don't publish turnover or profit figures - this is legal and normal. However, 100% of companies have balance sheet data (assets, liabilities, equity). Use hasPLFigures=true in your search filters to find companies with full P&L statements.

How often is data updated?

Data is updated regularly as new Companies House filings are processed. When you query a company, you get the most recent data available. No batch delays.

Can I use the API for commercial purposes?

Yes! All paid plans include commercial use rights. Use the data in your products, services, internal tools, or resell as part of your offerings. No restrictions.

What response format does the API use?

JSON. All responses are clean, structured JSON with consistent field names and data types. Financial prefixes: c = current year, p = previous year. Growth rates are returned as decimals (0.1 = 10%).

Is there a sandbox or test environment?

Yes! Sign up for free to get 25 credits with no card required. Use these to test all endpoints, explore data structure, and validate integration before committing to a paid plan.

How can I track my API usage?

Every API response includes an X-API-Key-Details header with your current usage stats: count (credits used), limit (total available), cost (credits this request cost), and reset (when credits reset). Example: count=26; limit=2000; cost=1; reset=2025-08-06T10:00:00.000Z

What if I need more than 500k credits per month?

Contact us about Enterprise Unlimited (£4,000/month) which includes unlimited credits with fair use policy. Typical enterprise usage ranges from 500k-2M credits monthly.

Ready to Start Building?

Get 25 free credits and start querying UK company data in minutes. No card required.

Start Free Trial View API Docs

Supported by

South of Scotland Enterprise logo