UK Company Data API - Financials, Employees, Filings

Search registered companies in the United Kingdom and Ireland and export the matches as clean rows. Filter by name, country, registration status, incorporation date, industry, keywords, website domain and region, and by the numbers companies actually file: employees, turnover, EBITDA, net assets, total assets and post-tax profit. Every financial filter has a growth twin, so you can ask for companies whose turnover grew more than 20 percent as easily as companies with turnover above 5 million. You pay only for the companies you actually receive.

This actor is built for building a target list of UK and Irish businesses, screening suppliers, sizing a market, running credit and risk prechecks, and finding fast-growing companies before anyone else does.

What you can do with it

• Build a list of active UK companies in a given industry, region and size band.
• Find high-growth companies by filtering on year-on-year turnover, EBITDA or headcount growth.
• Screen suppliers or prospects by net assets, total assets and post-tax profit before you commit.
• Pull registration number, incorporation date and official status for a compliance or KYC file.
• Match a list of website domains back to their registered legal entities.
• Export everything as JSON, CSV or Excel, or push it into your CRM or warehouse.

Features

• Every documented criterion is a real input field, built in the exact JSON shape the API expects: plain text for names, values plus mode for lists, and min plus max for ranges.
• Twelve range filters covering headcount and five financial measures, each with a value range and a year-on-year growth range.
• Match modes on the list filters, so any and all are both a single dropdown away.
• Country codes are lower-cased automatically, which is the only form the provider matches.
• A rawCriteria passthrough sends any criterion the API supports that is not modelled here, so a new filter never needs a code change.
• A preview toggle runs the same search against the provider sandbox, letting you check criteria without consuming live quota.
• Financial fields are split into a value column and a currency column, with the original object kept intact.
• The registered or primary address is preferred over whichever address happens to come first.
• Duplicate companies are removed across pages before anything is charged.
• Rate limits are handled with retry-after aware backoff, and a run that hits a limit keeps everything already collected.
• Pay-per-result pricing with a hard result cap so a run can never surprise you.

Input

Field	Type	Description
name	string	Match the registered company name.
countryCodes	array	Two-letter country codes, for example gb, ie.
simplifiedStatuses	array	Registration statuses such as Active.
incorporatedMin / incorporatedMax	string	Incorporation date window, YYYY-MM-DD.
industries, keywords, domainNames, regions	array	List filters on what a company does and where.
employeesMin / employeesMax	integer	Headcount range.
turnoverMin / turnoverMax	integer	Turnover range in the filing currency.
ebitdaMin / ebitdaMax	integer	EBITDA range.
netAssetsMin / netAssetsMax	integer	Net assets range.
totalAssetsMin / totalAssetsMax	integer	Total assets range.
postTaxProfitMin / postTaxProfitMax	integer	Post-tax profit range, negatives allowed.
…GrowthMin / …GrowthMax	integer	Year-on-year percentage change for each measure above.
creditRisk	array	Credit risk bands. Needs the credit report package.
countryCodesMode, industriesMode, keywordsMode	string	any or all for those list filters.
rawCriteria	object	Any extra criterion, merged last.
usePreviewDataset	boolean	Run against the sandbox instead of live data.
maxResults	integer	Stop after this many companies (1 to 20,000).
pageSize	integer	Companies per API call (1 to 100).
apiKey	string	Your API key. Required, stored securely.

At least one criterion is required.

Example output

Each dataset item is one company. Fields are populated where the provider has data, and the complete provider payload is kept under raw:

{
  "companyId": "06463016",
  "countryCode": "gb",
  "name": "Example Trading Limited",
  "type": "Private limited company",
  "incorporationDate": "2007-12-19",
  "officialStatus": "Active",
  "simplifiedStatus": "Active",
  "numberOfEmployees": 184,
  "turnover": 24800000,
  "turnoverCurrency": "GBP",
  "ebitda": 3100000,
  "ebitdaCurrency": "GBP",
  "netAssets": 9450000,
  "netAssetsCurrency": "GBP",
  "totalAssets": 18700000,
  "totalAssetsCurrency": "GBP",
  "postTaxProfit": 2240000,
  "postTaxProfitCurrency": "GBP",
  "creditRisk": "Low risk",
  "addressLine": "12 Example Street",
  "city": "Manchester",
  "region": "Greater Manchester",
  "postalCode": "M1 4AB",
  "addressCountry": "United Kingdom",
  "industries": ["Wholesale of electronic equipment"],
  "keywords": ["distribution", "electronics"],
  "domains": ["exampletrading.co.uk"],
  "raw": { "companyId": "06463016", "name": "Example Trading Limited" }
}

Pricing and the credit model

This actor uses pay-per-result pricing. You are charged a fixed price for each company delivered to the dataset, after duplicates are removed. A search that matches nothing costs nothing. Set maxResults to cap how many rows a run can collect, and set a run spending limit as a second safety net. Your own provider plan meters its own API calls separately, so a larger pageSize uses fewer of them for the same number of rows.

Bring your own API key

This actor connects to a third-party UK and Ireland company data provider (FullCircl, formerly DueDil) on your behalf and requires your own provider API key. It is stored securely and never logged, and the actor never ships with or shares credentials.

Frequently asked questions

What data does this actor return?

Registration number and country code, registered name and company type, incorporation date, official and simplified registration status, employee count, turnover, EBITDA, net assets, total assets and post-tax profit each with their currency, a credit risk band where your key includes it, the registered address broken into street, city, region, postal code and country, plus industries, keywords and website domains. Every record also carries the untouched provider payload.

Which countries are covered?

The company registry data covers the United Kingdom and Ireland. Pass the country codes in countryCodes as two-letter codes; the actor lower-cases them for you, since that is the only form the provider matches.

How do I find fast-growing companies?

Use the growth filters. Each financial measure has a percentage twin, so turnoverGrowthMin set to 20 returns companies whose turnover grew by at least 20 percent year on year. employeesGrowthMin does the same for headcount. Negative values select companies that shrank, which is useful for distress screening.

Why is my credit risk filter rejected?

Credit risk is a restricted criterion. It only works on API keys that include the credit report package, and the provider rejects the request outright otherwise. Remove creditRisk from the search or ask the provider to add the package to your key.

What is the preview dataset for?

Turning usePreviewDataset on runs the identical search against the provider's sandbox copy of the endpoint. It is the cheap way to confirm your criteria are well formed before spending live quota. The rows it returns are demo data, not real search results, so never treat them as live company records.

What is rawCriteria for?

It sends any criterion the data API accepts that does not yet have its own input field, in the API's own JSON shape. It is merged last, so it also overrides a modelled field when you need it to.

How does pagination work?

The API pages by offset and limit. The actor walks the offsets for you until it reaches maxResults, the provider's reported total, or a short page, and removes duplicates along the way.

How does the actor handle rate limits?

It throttles requests, honours the retry-after signal on a rate-limited response, and backs off exponentially. If the limit is still in force it stops early and keeps everything already collected rather than failing the whole run.

How am I charged?

You pay a fixed price per company returned to the dataset. Duplicates are removed before charging and empty runs cost nothing. Use maxResults and the run spending limit to control cost.

What output formats are available?

The dataset can be exported as JSON, CSV, Excel, HTML or RSS, or read through the API for pushing into a CRM or warehouse.

Keyword map

uk company data api, companies house data api, uk company search api, ireland company data, company financials api, turnover data uk companies, ebitda data api, net assets data, post tax profit data, company registration number lookup, uk business database, high growth companies list, company credit risk data, kyc company data, supplier screening data, b2b data uk, firmographic data uk, company incorporation date search, sic industry search uk, registered company address data.