Skip to main content
GET
Get company details

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

companyNumber
string
required

Companies House company number.

Response

200 - application/json

Company record from the product API (field-level shape in data dictionary).

Generated from The Data City data dictionary (schema ClassifiedCompany, version 1.0). See https://docs.thedatacity.com/data-dictionary/

AccountsOverdueByMoreThanAYear
boolean

A flag indicating the company's accounts are overdue by more than a year.

BestEstimateEBITDA
number<double>

Where OPERATING_PROFIT, DEPRECIATION_OF_TANGIBLES and AMORTISATION_OF_INTANGIBLES are available, these three values are summed.

BestEstimateEmployees
integer<int64>

Employees data is available for most companies. Occasionally there are gaps in reporting. Where there are gaps in reporting, we estimate the number of employees; this includes a projection of employees forwards and backwards. BestEstimateEmployees refers to the current year. BestEstimateEmployees may include overseas employees.

BestEstimateTurnover
integer<int64>

Available from Companies House for large companies, if absent then The Data City provide an estimate. The BestEstimate will report actual (reported) where available or it will be an estimate. BestEstimateTurnover refers to the current year: where accounts covering the current year have not been reported, the value is projected forward from the most recently reported year.

BestEstimateUKEmployees
integer<int64>

Similar to BestEstimateEmployees, but estimates only UK-based employees. BestEstimateUKEmployees currently refers to the latest complete year.

Bluesky
string

Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.

CICs
object[]

Custom Industrial Classifications (CICs) the company has been classified into. API includes the industry verticals within the same field. On the download, verticals are a separate column. These are custom RTICs.

CompanyCategory
string

Companies House data. The type of company, e.g. Publically Listed (PLC) or Limited (LTD).

CompanyDescription
string

Takes the description from the description meta tag from the homepage and the about page. We check this is in English.

CompanyExports
object[]

HMRC export trade data for the company.

CompanyFinancials_CreditSafe
object[]

Annual financial reporting from filings processed by Creditsafe. Creditsafe use a semi-automated process to convert scanned financial PDF documents into numerical/digital values. This process may lead to errors, e.g. reporting profit as turnover.

Generated from The Data City data dictionary (schema CompanyGrowthTrend, version 1.0). See https://docs.thedatacity.com/data-dictionary/

CompanyImports
object[]

HMRC import trade data for the company.

CompanyJobPostings
object[]

This company's job postings grouped by SOC4 occupation, one entry per occupation group, covering the most recent five years. See the CompanyJobPosting schema for the fields on each entry. Job postings data is a paid upgrade and is not included for all customers.

CompanyJobPostingsByLOTCodeOverTime
object[]

This company's monthly job posting counts and median advertised salary per LOT occupation, one entry per occupation per month, covering the most recent five years. Job postings data is a paid upgrade and is not included for all customers.

CompanyJobPostingsByLot
object[]

This company's job postings grouped by Lightcast Occupation Taxonomy (LOT) occupation, one entry per occupation, covering the most recent five years. See the CompanyJobPostingByLot schema for the fields on each entry. Job postings data is a paid upgrade and is not included for all customers.

CompanyJobPostingsBySOC4CodeOverTime
object[]

This company's monthly job posting counts and median advertised salary per SOC4 occupation, one entry per occupation per month, covering the most recent five years. Job postings data is a paid upgrade and is not included for all customers.

CompanyJobPostingsBySkill
object[]

This company's job postings grouped by common skill requested, covering the most recent five years. Despite the name this holds common skills only; specialised skills, software skills and certifications are returned separately and are not included here. See the CompanyJobPostingByCommonSkill schema for the fields on each entry. Job postings data is a paid upgrade and is not included for all customers.

CompanyJobPostingsOverTime
object

Generated from The Data City data dictionary (schema CompanyJobPostingsOverTime, version 1.0). See https://docs.thedatacity.com/data-dictionary/

CompanyName
string

Companies House data. Companies have the ability to change their company name through submission to Companies House.

CompanyNation
string

The company nation.

CompanyNumber
string

Companies House data. Unique key, doesn't change. Most important part of our data.

CompanyStatus
string

The company status as per Companies House.

ConsolidatedAccountsCompanyName
string[]

A list of company names within the same group structure that have consolidated accounts. This is a strong signal of the companies that are more likely to be the parent company. This is because it is common for the parent company to file consolidated accounts that include all the subsidiaries in the group structure.

ConsolidatedAccountsCompanyNumber
string[]

A list of company numbers within the same group structure that have consolidated accounts. This is a strong signal of the companies that are more likely to be the parent company. This is because it is common for the parent company to file consolidated accounts that include all the subsidiaries in the group structure.

CountryOfOrigin
string

Companies House data. Not to be confused with group structure (ParentCompanyNation, UltimateParentCompanyNation).

DealroomFunding
object[]

Legacy field, retained for backward compatibility only; use Investment instead.

DistinctBrandsInGroup
object[]

A list of distinct brands that can be found across the company's group structure.

ESGStatementAnchors
object[]

This is an array of ESG statement anchors. Each anchor is a string that is found in the company's website text.

ESG_RTIC
boolean

A boolean value indicating whether the company is in an ESG RTIC.

EmailAddresses
string[]

Emails are extracted from the website text. Director emails are prioritised. For matching directors to emails: any combination of the complete surname or first name with at least the first initial of the opposing field. No AI is used.

EstimatedGVA
number<double>

We have produced an estimated GVA measure at the company level. We have employee and SIC information for each company. This makes it possible to estimate a GVA value per company by multiplying a company's number of employees by the standard GVA employee contribution associated with that same company's SIC.

EstimatedUKGVA
number<double>

We have produced an estimated GVA measure at the company level. We have employee and SIC information for each company. This makes it possible to estimate a GVA value per company by multiplying a company's number of UK employees by the standard GVA employee contribution associated with that same company's SIC.

Facebook
string

Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.

GenderFoundedCategory
string

The company's single gender-leadership category based on its active founders. One of: All women led, Majority women led, Mixed led, Majority men led, All men led, Uncertain. Mutually exclusive — every company falls in exactly one.

GenderLedCategory
string

The company's single gender-leadership category based on its active directors. One of: All women led, Majority women led, Mixed led, Majority men led, All men led, Uncertain. Mutually exclusive — every company falls in exactly one.

HasBeenAcquired
boolean

True if the company has been acquired, based on funding rounds with an 'Acquisition' round type where this company is the target.

HasIPO
boolean

True if the company has listed on a public market, based on an IPO event in the investment feed.

HasMadeAcquisitions
boolean

True if the company has acquired another company, based on funding rounds with an 'Acquisition' round type where this company is the acquirer.

HighGrowth
boolean

A boolean value indicating whether the company is a high growth company.

Homepage_domain
string

Goes through the large web-scraping/matching process.

IS8Codes
object[]

Industrial Strategy Sector codes associated with the company, derived from RTICs and RSICs.

IncorporationDate
string<date>

Companies House data.

InnovateUKFunding
object[]

Information about the projects funded by Innovate UK from 2004. Source: https://www.ukri.org/publications/innovate-uk-funded-projects-since-2004/

InnovationKeywords
string[]

We have a large list of emerging economy keywords. We loop through the web text to see if the web text contains the keyword. If they do, the keyword is assigned to the company.

InnovationScore
number<double>

We present this on the platform as stars but the API is actually a numerical value which gets categorised. The result is a binary classifier. The company is either innovative or it is not. The confidence increases the higher the score.

Instagram
string

Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.

Investment
object[]

Per-round investment data matched to a CompanyNumber with high confidence. TotalInvestmentRaised_GBP_Million is the sum of all rounds, except Debt and Acquisition rounds. This is the total across the provider's tracking period and is not the total in one particular year.

IsBCorp
boolean

A flag of whether a company is a B Corp. This is based on a list of B Corps that we have obtained from B Corp and matched to our companies.

IsLikelyAgency
boolean

A boolean value indicating whether the company is likely to be an agency. This is based on assessment of the company's financials.

IsLikelySPV
boolean

A flag indicating the company is likely a special purpose vehicle (SPV), based on an ML model applied to Companies House data.

LatestRoundAmount
number<double>

The amount raised in the company's most recent funding round. This is the individual round amount, not the company's total funding raised across all rounds.

LatestRoundDate
string<date-time>

The date of the company's most recent funding round.

LatestRoundType
string

The round type of the company's most recent funding round (e.g. 'Seed', 'Series A').

LatestRoundValuation
number<double>

The company's valuation as reported for its most recent funding round, in GBP. Not all rounds have a disclosed or estimated valuation.

LinkedCompanyNumbers
string[]

A list of company numbers that are linked to the company, even if they are not connected through group structure. This is based on a combination of signals including shared officers, shared addresses, shared shareholders, and other signals.

Linkedin
string

Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.

LocationDetails
object[]

An array of location objects with postcode-related fields.

ManufacturingKeywords
string[]

We have a large list of manufacturing keywords. We loop through the web text to see if the web text contains the keyword. If they do, the keyword is assigned to the company.

NumberOfCurrentDirectors
integer<int32>

The number of directors currently appointed to the company, i.e. those with no resignation date recorded whose role is Director. Excludes other officer roles such as company secretaries, LLP members and managing officers, so a limited liability partnership will typically report zero current directors.

NumberOfCurrentOfficers
integer<int32>

The number of officers currently appointed to the company, i.e. those with no resignation date recorded. Counts all officer roles, including company secretaries and LLP members, not only directors.

OECDScaleup
boolean

A boolean value indicating whether the company is an OECD defined scale-up.

Officers
object[]
ParentNation
string

The nation of the parent company.

PhoneNumbers
string[]

CreditSafe provide The Data City with CTPS approved phone numbers. Phone numbers are extracted from the website text.

RSICs
object[]

Real-Time SIC (RSIC) codes with associated confidence score

RTICs
object[]

RTICs the company has been classified into. API includes the industry verticals within the same field. On the download, verticals are a separate column.

RegisteredAddress
string

Companies House data. The companies registered address as registered on Companies House. This is not to be confused with their head office. Not sourced from CreditSafe.

RegisteredPostcode
string

Companies House data. Not to be confused with head office (we do not know this at this stage). Not sourced from CreditSafe.

SICHLUs
string[]

Companies House data. SIC Sections. Nature of business: Standard Industrial Classification (SIC) codes.

SICs
string[]

Companies House data. Nature of business: Standard Industrial Classification (SIC) codes.

SectorKeywords
string[]

We have a large list of emerging economy keywords. We loop through the web text to see if the web text contains the keyword. If they do, the keyword is assigned to the company.

SimilarCompanies
object[]

Our similarity score adopts measures of mathematical similarity to find similar companies using their website text. Companies with website text with the same words are more likely to report a higher level of similarity.

SimilarCompositeCompanies
object[]

Our composite similarity score.

Spinout
boolean

True if the company is a spinout, sourced from the HESA spinout register. A spinout is a company created to commercialise research or technology developed at a university or research institution.

TonnesOfC02equivGHGPerYear
number<double>

We estimate greenhouse gas emissions based on a published table of total carbon emissions by SIC sector. We assume that carbon emissions are spread equally across all companies within the SIC sector in proportion to their number of employees. Therefore, we only hold an estimate for a limited number of companies.

Twitter
string

Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.

URLMatchStats
object

Generated from The Data City data dictionary (schema UrlMatchStat, version 1.0). See https://docs.thedatacity.com/data-dictionary/

UltimateLinkedCompanyNumber
string

The ultimate linked company number in the group structure. This is the company number that was first incorporated within the collection of linked companies.

UltimateParentNation
string

The nation of the ultimate parent company.

UltimateUKParentCompanyNames
string[]

A list of company names belonging to companies in the group that are the highest level UK registered companies.

UltimateUKParentCompanyNumbers
string[]

A list of company numbers belonging to companies in the group that are the highest level UK registered companies.

WomenLedStats
object

Generated from The Data City data dictionary (schema WomanLedStats, version 1.0). See https://docs.thedatacity.com/data-dictionary/

Youtube
string

Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.

_360GivingFunding
object[]

Data provided by a charity that helps organisations to publish open, standardised grants data, and supports people to use it to improve charitable giving. Source: https://grantnav.threesixtygiving.org/

Last modified on August 20, 2026