API
If you’re a paid subscriber to our API, you can learn more about the endpoints that you have access to here: https://product-api.thedatacity.com/api/documentation
Data Fields
Company Number
🔗 Name on API: CompanyNumber
📥 Name on Download: Companynumber
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source:
🔍 Description: Companies House data. Unique key, doesn’t change. Most important part of our data.
🌐 Knowledge Base: Companies House
🔄 Update Cycle: Bi-Monthly
Company Name
🔗 Name on API: CompanyName
📥 Name on Download: Companyname
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source:
🔍 Description: Companies House data. Companies have the ability to change their company name through submission to Companies House.
🔄 Update Cycle: Bi-Monthly
Country Of Origin
🔗 Name on API: CountryOfOrigin
📥 Name on Download: Countryoforigin
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source:
🔍 Description: Companies House data. Not to be confused with group structure (ParentCompanyNation, UltimateParentCompanyNation).
🔄 Update Cycle: Bi-Monthly
Incorporation Date
🔗 Name on API: IncorporationDate
📥 Name on Download: IncorporationDate/SortableIncorporationDate
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source:
🔍 Description: Companies House data.
🔄 Update Cycle: Bi-Monthly
Registered Address
🔗 Name on API: RegisteredAddress
📥 Name on Download: Registeredaddress
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source: Companies House data.
🔍 Description: Companies House data. The companies registered address as registered on Companies House. This is not to be confused with their head office.
🌐 Knowledge Base: Calculating Locations
🔄 Update Cycle: Bi-Monthly
Registered Postcode
🔗 Name on API: RegisteredPostcode
📥 Name on Download: Registeredpostcode
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source:
🔍 Description: Companies House data. Not to be confused with head office (we do not know this at this stage).
🌐 Knowledge Base: Calculating Locations
🔄 Update Cycle: Bi-Monthly
Company Category
🔗 Name on API: CompanyCategory
📥 Name on Download: Companycategory
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source:
🔍 Description: Companies House data. The type of company, e.g. Publically Listed (PLC) or Limited (LTD).
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: Email
📥 Name on Download: Email
🗂️ Primary Data Source: Web Scraping
📊 Secondary Data Source:
🔍 Description: 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.
🔄 Update Cycle: Bi-Monthly/Quarterly
Phone
🔗 Name on API: Phone
📥 Name on Download: Telephone
🗂️ Primary Data Source: CreditSafe
📊 Secondary Data Source: Web-scraping
🔍 Description: CreditSafe provide TDC with CTPS approved phone numbers. Phone numbers are extracted from the website text.
🔄 Update Cycle: Bi-Monthly/Quarterly
🔗 Name on API: Linkedin
📥 Name on Download: Linkedin
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source:
🔍 Description: Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.
🔄 Update Cycle: Bi-Monthly/Quarterly
🔗 Name on API: Twitter
📥 Name on Download: Twitter
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source:
🔍 Description: Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.
🔄 Update Cycle: Bi-Monthly/Quarterly
YouTube
🔗 Name on API: Youtube
📥 Name on Download: Youtube
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source:
🔍 Description: Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.
🔄 Update Cycle: Bi-Monthly/Quarterly
🔗 Name on API: Facebook
📥 Name on Download: Facebook
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source:
🔍 Description: Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.
🔄 Update Cycle: Bi-Monthly/Quarterly
🔗 Name on API: Instagram
📥 Name on Download: Instagram
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source:
🔍 Description: Takes the most common anchor link which contains the social media domain. We prioritise social media links that are found on the homepage.
🔄 Update Cycle: Bi-Monthly/Quarterly
Website
🔗 Name on API: Homepage_domain
📥 Name on Download: URLs
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source: CreditSafe, Charity Data
🔍 Description: Goes through the large web-scraping/matching process.
🌐 Knowledge Base: URL Matching
🔄 Update Cycle: Bi-Monthly/Quarterly
Description
🔗 Name on API: Homepage_description, About_page_description
📥 Name on Download: Description
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source:
🔍 Description: Takes the description from the description meta tag from the homepage and the about page. We check this is in English.
🔄 Update Cycle: Bi-Monthly/Quarterly
Locations
🔗 Name on API: LocationDetails
This is an array of location objects with the following fields. Each location object contains the following fields all related to a single location (postcode).
🌐 Knowledge Base: Calculating Locations and Location filters
📑 Sub Fields
🔗 Name on API: Postcode
📥 Name on Download: Postcodes
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source: CreditSafe, Web-scraping
🔍 Description: A postcode for the company.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - Postcode_withspaces
📥 Name on Download:
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source: CreditSafe, Web-scraping
🔍 Description: A postcode for the company with formatted spaces.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - Longitude
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The longitude of the location.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - Latitude
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The latitude of the location.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - LAcode
📥 Name on Download: Localauthoritycodes
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The local authority code the postcode resides in.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - LEPcode
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The local enterprise partnership code the postcode resides in.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - LEPname
📥 Name on Download: LEPs
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The local enterprise partnership name the postcode resides in.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - StandardisedCity
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The functional urban area (FUA) the postcode resides in. The cities filter consists of UK (FUA) as defined by the OECD. An FUA is composed of a core city and its commuting zone. The cities filter represents the urban zone. This is an update from the 2012 definition.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - NUTS1NM
📥 Name on Download: NUTS1
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The NUTS1 region name the postcode resides in.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - NUTS1
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The NUTS1 region code the postcode resides in.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - NUTS2
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The NUTS2 region code the postcode resides in.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - NUTS3
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The NUTS3 region code the postcode resides in.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - UKConstituency
📥 Name on Download: Constituencies
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The constituency name the postcode resides in. The constituencies filter is comprised of UK parliamentary constituencies.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - FoundOnWebpage
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: A boolean value to indicate if the postcode was found on the company’s website.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - RegisteredPostcode
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: A boolean value to indicate if the postcode is the registered postcode.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - Ward
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The ward code the postcode resides in.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - OECDFUACore
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The functional urban core area (FUA) the postcode resides in. The cities filter consists of UK FUAs as defined by the OECD. An FUA is composed of a core city and its commuting zone. The cities filter represents the urban zone. This is an update from the 2012 definition.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: - OECDFUACorePlusCommuting
📥 Name on Download: OECDcities
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The functional urban commuting area (FUA) the postcode resides in. The cities filter consists of UK FUAs as defined by the OECD. An FUA is composed of a core city and its commuting zone. The cities filter represents the urban zone. This is an update from the 2012 definition.
🔄 Update Cycle: Monthly/Bi-Monthly
SICs
🔗 Name on API: SICs
📥 Name on Download: SICs
🗂️ Primary Data Source: Companies House
📊 Secondary Data Source:
🔍 Description: Companies House data. Nature of business: Standard Industrial Classification (SIC) codes
🌐 Knowledge Base: What is the difference between RTICs & SIC codes?
🔄 Update Cycle: Bi-Monthly
SICHLUs
🔗 Name on API: SICHLUs
📥 Name on Download: SICHLUs
🗂️ Primary Data Source: Companies House data.
📊 Secondary Data Source:
🔍 Description: Companies House data. SIC Sections. Nature of business: Standard Industrial Classification (SIC) codes
🌐 Knowledge Base: What is the difference between RTICs & SIC codes?
🔄 Update Cycle: Monthly/Bi-Monthly
Sector Keywords
🔗 Name on API: SectorKeywords
📥 Name on Download: Sectorkeywords
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source:
🔍 Description: 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.
🌐 Knowledge Base: Sector Keywords
🔄 Update Cycle: Quarterly
Innovation Keywords
🔗 Name on API: InnovationKeywords
📥 Name on Download:
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source:
🔍 Description: 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.
🌐 Knowledge Base: Innovation Keywords
🔄 Update Cycle: Bi-Monthly
Manufacturing Keywords
🔗 Name on API: ManufacturingKeywords
📥 Name on Download:
🗂️ Primary Data Source: Web-scraping
📊 Secondary Data Source:
🔍 Description: 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.
🔄 Update Cycle: Bi-Monthly
Company Financials
🔗 Name on API: CompanyFinancials_CreditSafe
This is an array of financial objects with the following fields. Each financial object contains the following fields all related to a single financial year
Financial reporting submitted to Companies House. 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.
🌐 Knowledge Base: Creditsafe
📑 Sub Fields
🔗 Name on API: MADE_FROM_DATE
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Accounting From Date (ISO 8601 string).
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: MADE_UPTO_DATE
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Accounting To Date (ISO 8601 string).
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: NUM_OF_MONTHS
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Number of months the financials cover.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: CURRENCY
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Currency the financials are reported in.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: CONSOLIDATED_ACS
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Boolean. True if the financials are consolidated.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ACCOUNTS_FORMAT
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Format of the submitted accounts.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TURNOVER
📥 Name on Download: Reported_Turnover
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Turnover as submitted to Companies House.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: PRE_TAX_PROFIT
📥 Name on Download: Pretaxprofit
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Pre-tax profit.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: PROFIT_AFTER_TAX
📥 Name on Download: Profitaftertax
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Profit after tax.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: CASH
📥 Name on Download: Cash
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Cash at bank in hand.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TOTAL_CURRENT_ASSETS
📥 Name on Download: Totalcurrentassets
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Total current assets.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TOTAL_ASSETS
📥 Name on Download: Totalassets
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Total assets.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TOTAL_CURRENT_LIABILITIES
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Total current liabilities.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TOTAL_LIABILITIES
📥 Name on Download: Totalliabilities
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Total liabilities.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: SHAREHOLDER_FUNDS
📥 Name on Download: Shareholderfunds
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Shareholder funds.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: NET_WORTH
📥 Name on Download: Networth
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Net worth of the company.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: NUMBER_OF_EMPLOYEES
📥 Name on Download: Reported_Numberofemployees
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Employees as submitted to Companies House.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: AUDITORS
📥 Name on Download: Auditors
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Auditors.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ACCOUNTANT_NAME
📥 Name on Download: Accountantname
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Accountant name.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: OPERATING_PROFIT
📥 Name on Download: Operatingprofit
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Operating profit.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: DEPRECIATION_OF_TANGIBLES
📥 Name on Download: Depreciationoftangibles
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Depreciation of tangibles.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: AMORTISATION_OF_INTANGIBLES
📥 Name on Download: Amortisationofintangibles
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Amortisation of intangibles.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: DEBTORS_DUE_AFTER_ONE_YEAR
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Debtors due after one year.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: DEBTORS
📥 Name on Download: Debtors
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Debtors.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TRADE_DEBTORS
📥 Name on Download: Tradedebtors
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Trade debtors.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: GROUP_DEBTORS
📥 Name on Download: Groupdebtors
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Group debtors.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: CREDITORS
📥 Name on Download: Creditors
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Creditors.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: DECREASE_OR_INCREASE_IN_CASH
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Decrease or increase in cash.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: EXPORT
📥 Name on Download: Export
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Export.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: WAGES_AND_SALARIES
📥 Name on Download: WagesAndSalaries
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Wages and salaries.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BANK_OVERDRAFT
📥 Name on Download: Bankoverdraft
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Bank overdraft.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: YEAR
📥 Name on Download: Yearending
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: Year ending.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: EBITDA
📥 Name on Download: EBITDA
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: A calculation. OPERATING_PROFIT + DEPRECIATION_OF_TANGIBLES + AMORTISATION_OF_INTANGIBLES
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: DECLARED_EMPLOYEES_ANOMALOUS
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: Boolean. True if the number of employees is declared as anomalous.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: EMPLOYEES_ANOMALOUS_PROBABILITY
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: Float. The probability that the number of employees is declared as anomalous. 0.5 is the threshold.
🔄 Update Cycle: Monthly/Bi-Monthly
Officers (Directors)
🔗 Name on API: Officers
This is an array of officer objects with the following fields. Each officer object contains the following fields all related to a single officer.
These are officers as per Companies House. E.g. https://find-and-update.company-information.service.gov.uk/company/10958787/officers
📑 Sub Fields
📑 Name on API: Title
📥 Name on Download: Title
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The title of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: Surname
📥 Name on Download: Surname
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The surname of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: Forenames
📥 Name on Download: Forenames
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The forenames of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: Role
📥 Name on Download: Role
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The role of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: PersonNumber
📥 Name on Download: PersonNumber
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The person number of the officer. Person number is a unique identifier for the officer provided by Companies House.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: Appointedon
📥 Name on Download: Appointedon
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The date the officer was appointed.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: ResignationDate
📥 Name on Download: ResignationDate
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The date the officer resigned (if applicable).
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: DOB
📥 Name on Download: DOB
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The date of birth of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: Nationality
📥 Name on Download: Nationality
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The nationality of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: Occupation
📥 Name on Download: Occupation
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The occupation of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: UsualResidentialCountry
📥 Name on Download: UsualResidentialCountry
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The usual residential country of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: AddressLine1
📥 Name on Download: AddressLine1
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The first line of the address of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: AddressLine2
📥 Name on Download: AddressLine2
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The second line of the address of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: Careof
📥 Name on Download: Careof
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The care of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: Country
📥 Name on Download: Country
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The country of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: County
📥 Name on Download: County
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The county of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: Honours
📥 Name on Download: Honours
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The honours of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
📑 Name on API: PostTown
📥 Name on Download: PostTown
🗂️ Primary Data Source:
📊 Secondary Data Source:
🔍 Description: The post town of the officer.
🔄 Update Cycle: Monthly/Bi-Monthly
Estimated Greenhouse Gas Emissions
🔗 Name on API: TonnesOfC02equivGHGPerYear
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: 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.
🌐 Knowledge Base:: How do you get greenhouse gas emissions data per company?
🔄 Update Cycle: Bi-Monthly
RTICs (Real Time Industrial Classifications)
🔗 Name on API: RTICs
This is an array of RTIC objects with the following fields. Each RTIC object contains the following fields all related to a single RTIC.
RTICs the company has been classified into. API includes the industry verticals within the same field. On the download, verticals are a separate column.
🌐 Knowledge Base: RTICs
📑 Sub Fields
📑 Name on API: RTICCode
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The RTIC vertical code.
🔄 Update Cycle: Ad-Hoc
📑 Name on API: RTICName
📥 Name on Download: RTICsubsectors
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The RTIC vertical name.
🔄 Update Cycle: Ad-Hoc
📑 Name on API: ParentCode
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The RTIC code.
🔄 Update Cycle: Ad-Hoc
📑 Name on API: ParentName
📥 Name on Download: RTICs
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The RTIC name.
🔄 Update Cycle: Ad-Hoc
📑 Name on API: CIC
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: A boolean value to indicate if the RTIC is a CIC. CICs are custom RTICs.
🔄 Update Cycle: Ad-Hoc
CICs (Custom Industrial Classification)
🔗 Name on API: CICs
📥 Name on Download: CICs
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: 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.
🌐 Knowledge Base: CICs
🔄 Update Cycle: Ad-Hoc
Similar Companies
🔗 Name on API: SimilarCompanies
This is an array of similar company objects with the following fields. Each similar company object contains the following fields all related to a similar company.
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.
** 🌐 Knowledge Base:** Similar Companies
📑 Sub Fields
📑 Name on API: CompanyOne
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The company number of the first company (the company you are looking at).
🔄 Update Cycle: Bi-Monthly/Quarterly
📑 Name on API: CompanyTwo
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The company number of the second company (the company that is similar).
🔄 Update Cycle: Bi-Monthly/Quarterly
📑 Name on API: Similarity
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: A numerical value representing the similarity between the two companies.
🔄 Update Cycle: Bi-Monthly/Quarterly
Innovation Score
🔗 Name on API: InnovationScore
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: 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.
🌐 Knowledge Base: Innovation Score
🔄 Update Cycle: Quarterly
Best Estimate Turnover
🔗 Name on API: BestEstimateTurnover
📥 Name on Download: BestEstimateCurrentTurnover
🗂️ Primary Data Source: TDC (CompaniesHouse)
📊 Secondary Data Source:
🔍 Description: Available from Companies House for large companies, if absent then TDC provide estimate. The BestEstimate will report actual (reported) where available or it will be an estimate. BestEstimateTurnover currently refers to the latest complete year.
🌐 Knowledge Base: Estimated turnover, employees and growth
🔄 Update Cycle: Bi-Monthly
Best Estimate Employees
🔗 Name on API: BestEstimateEmployees
📥 Name on Download: BestEstimateCurrentEmployees
🗂️ Primary Data Source: TDC (CompaniesHouse)
📊 Secondary Data Source:
🔍 Description: 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 to 2024, and back to 2014.
BestEstimateCurrentEmployees currently refers to the latest complete year.
🌐 Knowledge Base: Estimated turnover, employees and growth
🔄 Update Cycle: Bi-Monthly
EBITDA
🔗 Name on API: BestEstimateEBITDA
📥 Name on Download: EBITDA
🗂️ Primary Data Source: Calculated
📊 Secondary Data Source:
🔍 Description: Where OPERATING_PROFIT, DEPRECIATION_OF_TANGIBLES and AMORTISATION_OF_INTANGIBLES are available, these three values are summed.
🔄 Update Cycle: Monthly/Bi-Monthly
Group Structure
🔗 Name on API: GroupStructure
This is an object with the following fields. Group structure data is supplied by CreditSafe and is based on the Persons with Significant Control (PSC) data submitted to Companies House.
Tip: Open Ownership is a great way to visualise this here.
📑 Sub Fields
🔗 Name on API: ULTIMATE_PARENT_NO
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The ultimate parent company number.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: PARENT_NO
📥 Name on Download: UltimateParentCompany
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The parent company number.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: COMPANY_NATION
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The company nation.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: COMPANY_LEVEL
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The company level in the group structure.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: HOLDING_TYPE
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The relationship between the parent and child.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ULTIMATE_PARENT_NAME
📥 Name on Download: UltimateParentCompany
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The ultimate parent company name.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: PARENT_NAME
📥 Name on Download: ParentCompany
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The parent company name.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ULTIMATE_PARENT_NATION
📥 Name on Download: UltimateParentCompanyNation
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The ultimate parent company nation.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: PARENT_NATION
📥 Name on Download: ParentCompanyNation
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The parent company nation.
🔄 Update Cycle: Monthly/Bi-Monthly
Funding Rounds
🔗 Name on API: DealroomFunding
This is an array of funding round objects with the following fields. Each funding round object contains the following fields all related to a single funding round.
The Data City has matched a considerable amount of Dealroom’s companies (with their help) to a CompanyNumber with >95% confidence. For each company, round data is available for all users.
TotalFundingRaised_GBP_Million is the sum of all rounds, except Debt and Acquisition rounds. This is the total across Dealroom’s tracking period and is not the total in one particular year.
🌐 Knowledge Base: Dealroom
📑 Sub Fields
🔗 Name on API: DealroomID
📥 Name on Download:
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: The Dealroom ID of the company.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: DealroomName
📥 Name on Download:
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: The Dealroom name of the company.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: LastFundingDate
📥 Name on Download: LastKnownDealroomFunding
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: The last funding date.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: RoundType
📥 Name on Download:
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: The round type.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: RoundInvestorName
📥 Name on Download:
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: The round investor name.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: RoundAmount
📥 Name on Download:
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: The round amount.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: RoundDate
📥 Name on Download:
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: The round date.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: RoundVerified
📥 Name on Download:
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: A boolean. 1 if the round is verified by Dealroom.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: Spinout
📥 Name on Download:
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: A boolean. 1 if the company is a spinout.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: TotalFundingRaised_GBP_Million
📥 Name on Download: TotalDealroomFundingMillionPounds
🗂️ Primary Data Source: Dealroom
📊 Secondary Data Source:
🔍 Description: The total funding the company has raised. DEBT and ACQUISITION rounds are not included in this total.
🔄 Update Cycle: Bi-Monthly
Innovate UK Funding Rounds
🔗 Name on API: InnovateUKFunding
This is an array of Innovate UK funding round objects with the following fields. Each funding round object contains the following fields all related to a single funding round.
Information about the projects funded by Innovate UK from 2004. Source: https://www.ukri.org/publications/innovate-uk-funded-projects-since-2004/
🌐 Knowledge Base: Innovate UK
📑 Sub Fields
🔗 Name on API: CompetitionYear
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The competition year.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ProjectStartDate
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The project start date.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ProjectEndDate
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The project end date.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: AwardOffered
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The value of the award.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TotalCosts
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The total costs of the project.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ActualSpendtoDate
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The actual spend to date.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: CompetitionReference
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The competition reference.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: CompetitionTitle
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The competition title.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ProgrammeTitle
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The programme title.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Sector
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The sector of the project.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ApplicationNumber
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The application number.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ProjectNumber
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The project number.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ProjectTitle
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The project title.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: PublicDescription
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The public description of the project.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: InnovateUKProductType
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The product type of the project.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ParticipantName
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The participant name (usually the company name).
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: IsLeadParticipant
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: A boolean. “Yes” if the participant is the lead participant.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ParticipantWithdrawnFromProject
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: A boolean. “Active” if the participant is still active in the project.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ProjectStatus
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The status of the project.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: EnterpriseSize
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The size of the company.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Postcode
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: The postcode of the project.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: IndustrialStrategyChallengeFundISCF
📥 Name on Download:
🗂️ Primary Data Source: InnovateUK
📊 Secondary Data Source:
🔍 Description: A boolean. “Yes” if the project is part of the Industrial Strategy Challenge Fund.
🔄 Update Cycle: Monthly/Bi-Monthly
360 Giving funding rounds
🔗 Name on API: _360GivingFunding
This is an array of 360 Giving funding round objects with the following fields. Each funding round object contains the following fields all related to a single funding round.
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/
🌐 Knowledge Base: 360 Giving
📑 Sub Fields
🔗 Name on API: title
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The title of the grant.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: currency
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The currency of the grant.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: awardDate
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The date the grant was awarded.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: description
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: A description of the grant.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Primaryissue
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The primary issue the grant is for.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: amountAwarded
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The amount awarded.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: grantProgrammeTitle
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The title of the grant programme.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ImpactCategory
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The impact category of the grant.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: recipientURL
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The URL of the recipient.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: funderName
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The name of the funder.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: recipientName
📥 Name on Download:
🗂️ Primary Data Source: 360Giving
📊 Secondary Data Source:
🔍 Description: The name of the recipient.
🔄 Update Cycle: Monthly/Bi-Monthly
Persons with Significant Control (PSC)
🔗 Name on API: PersonsWithSignificantControl
This is an array of persons with significant control objects with the following fields. Each person object contains the following fields all related to a single person. It is based on the Persons with Significant Control (PSC) data submitted to Companies House.
📑 Sub Fields
🔗 Name on API: Title
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The title of the person.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Name
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The name of the person.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: DoB
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The date of birth of the person.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Type
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The type of the person’s control.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: CountryOfResidence
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The country of residence of the person.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: NatureOfControl
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The nature of the person’s control.
🔄 Update Cycle: Monthly/Bi-Monthly
Shareholders
🔗 Name on API: ShareHolders
This is an array of shareholder objects with the following fields. Each shareholder object contains the following fields all related to a shareholder. It is based on shareholders data submitted to Companies House via filings.
📑 Sub Fields
🔗 Name on API: SHARE_TYPE
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The type of the share.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: SHARE_HOLDER_NAME
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The name of the shareholder.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: SHARE_HOLDING
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The holding of the share as a value.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: TOTAL_SHARES
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The total number of shares.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: CURRENCY
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The currency of the share.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: TOTAL_SHARE_VALUE
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The total value of the shares.
🔄 Update Cycle: Bi-Monthly
🔗 Name on API: SHARE_PERCENT
📥 Name on Download:
🗂️ Primary Data Source: Companies House (CreditSafe)
📊 Secondary Data Source:
🔍 Description: The percentage of the share.
🔄 Update Cycle: Bi-Monthly
URL Match Stats (URL Matching) Non-commercial
🔗 Name on API: URLMatchStats
This is an object with the following fields. It is based on the URL matching process.
📑 Sub Fields
🔗 Name on API: MatchedWebsite
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The matched website.
🔄 Update Cycle: Bi-Monthly/Quarterly
🔗 Name on API: MatchedWebsiteScore
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The matched website score. The higher the score the more confident we are that the website is a match.
🔄 Update Cycle: Bi-Monthly/Quarterly
🔗 Name on API: MatchedWebsiteSources
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The matched website sources. The sources we used to match the website.
🔄 Update Cycle: Bi-Monthly/Quarterly
🔗 Name on API: MatchedWebsiteReasoning
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: An array of reasons for the match.
🔄 Update Cycle: Bi-Monthly/Quarterly
Job Postings
🔗 Name on API: CompanyJobPostings
📑 Sub Fields: CompanyNumber, SOC4Code, SOC4Name, Postings, MedianSalary
📥 Name on Download:
🗂️ Primary Data Source: Lightcast
📊 Secondary Data Source:
🔍 Description: Job postings data is sourced from Lightcast. Currently this data is not available to all customers. We offer this as an upgrade.
Lightcast take individual job postings from multiple sources and classify these jobs into SOC4 codes. SOC stands for Standard Occupational Classifications and is a common classification of occupational information for the UK. We have matched 1.3m Lightcast companies to our 1.7m~ website matched companies. The data represents aggregations for the last two years. We set a minimum count threshold for each category. For each job posting, they also pull keywords related to skills.
🔄 Update Cycle: Quarterly
Job Postings by LOT
🔗 Name on API: CompanyJobPostingsByLot
📑 Sub Fields: CompanyNumber, LotCode, LotName, Postings, MedianSalary
📥 Name on Download:
🗂️ Primary Data Source: Lightcast
📊 Secondary Data Source:
🔍 Description: Job postings data is sourced from Lightcast. Currently this data is not available to all customers. We offer this as an upgrade.
Lightcast take individual job postings from multiple sources and classify these jobs into Lightcast Occupational Taxonomy (LOT) codes. We have matched 1.3m Lightcast companies to our 1.7m~ website matched companies. The data represents aggregations for the last two years. We set a minimum count threshold for each category. For each job posting, they also pull keywords related to skills.
🔄 Update Cycle: Quarterly
Job Postings By Skill
🔗 Name on API: CompanyJobPostingsBySkill
📑 Sub Fields: CompanyNumber, SkillName, TotalPostings, UniquePostings, MedianPostingDuration
📥 Name on Download:
🗂️ Primary Data Source: Lightcast
📊 Secondary Data Source:
🔍 Description: Job postings data is sourced from Lightcast. Currently this data is not available to all customers. We offer this as an upgrade.
Lightcast take individual job postings from multiple sources and classify these jobs into SOC4 codes. SOC stands for Standard Occupational Classifications and is a common classification of occupational information for the UK. We have matched 1.3m Lightcast companies to our 1.7m~ website matched companies. The data represents aggregations for the last two years. We set a minimum count threshold for each category. For each job posting, they also pull keywords related to skills.
🔄 Update Cycle: Quarterly
Company growth trends
🔗 Name on API: CompanyGrowthTrends
This is an object with the following fields. It is based on the company growth trends data.
🌐 Knowledge Base: Estimated turnover, employees and growth
📑 Sub Fields
🔗 Name on API: CompanyAgeInDays
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The age of the company in days.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: SICs
📥 Name on Download:
🗂️ Primary Data Source: Companies House.
📊 Secondary Data Source:
🔍 Description: An array of SIC codes the company belongs to.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimatedTurnoverToEmployeeRatio
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: A ratio of the best estimated turnover to the best estimated employees. This is calculated across the SIC(s) a company belongs to.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: CompanyGrowthStageEstimate
📥 Name on Download: CompanyGrowthStage
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: Company size estimate. This is a categorical value and is based on the Companies Act 2006 definition.
🌐 Knowledge Base: Company size categories.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimateCurrentEmployees
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: The best estimate of the current number of employees.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimateCurrentTurnover
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: The best estimate of the current turnover.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: EmploymentEstimates
This is an array with the following fields. It is based on the employment estimates data. Financials are used to estimate the number of employees.
📑 Sub Fields
🔗 Name on API: Year
📥 Name on Download: Yearending
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: The financial year.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Measure
📥 Name on Download: Reported_Numberofemployees
🗂️ Primary Data Source: Creditsafe
📊 Secondary Data Source: TDC
🔍 Description: The measured number of employees.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Estimated
📥 Name on Download: BestEstimate_Numberofemployees
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: The estimated number of employees.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TurnoverEstimates
This is an array with the following fields. It is based on the turnover estimates data. Financials are used to estimate their turnover over time.
📑 Sub Fields
🔗 Name on API: Year
📥 Name on Download: Yearending
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: The financial year.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Measure
📥 Name on Download: Reported_Turnover
🗂️ Primary Data Source: Creditsafe
📊 Secondary Data Source: TDC
🔍 Description: The measured turnover.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Estimated
📥 Name on Download: BestEstimate_Turnover
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: The estimated turnover.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimateEmployeeGrowthPercentagePerYear
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: Employment growth percentage per year.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimateTurnoverGrowthPercentagePerYear
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: Turnover growth percentage per year.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimateGrowthPercentagePerYear
📥 Name on Download: BestEstimateGrowthPercentagePerYear
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: Growth percentage per year. This is an average of the turnover and employee growth percentages in EXPLORE. On ANALYSE, BestEstimateGrowthPercentagePerYear refers to BestEstimateEmployeeGrowthPercentagePerYear.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimateTurnoverGrowthPercentagePerYearError
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: An error value for the turnover growth percentage per year.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimateEmployeeGrowthPercentagePerYearError
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: An error value for the employee growth percentage per year.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimateTurnoverGrowthFitParameters
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: A key value pair of the turnover growth fit parameters.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: BestEstimateEmployeeGrowthFitParameters
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Creditsafe
🔍 Description: A key value pair of the employee growth fit parameters.
🔄 Update Cycle: Monthly/Bi-Monthly
Company Job Postings By Common Skill
🔗 Name on API: CompanyJobPostingsByCommonSkill
📥 Name on Download:
🗂️ Primary Data Source: Lightcast
📊 Secondary Data Source:
🔍 Description: Job postings data is sourced from Lightcast. Currently this data is not available to all customers. We offer this as an upgrade.
Common skills refer to transferrable skills, such as communication, or team work. A library of skills is maintained by Lightcast.
🔄 Update Cycle: Quarterly
Company Job Postings By Certifications Skill
🔗 Name on API: CompanyJobPostingsByCertificationsSkill
📥 Name on Download:
🗂️ Primary Data Source: Lightcast
📊 Secondary Data Source:
🔍 Description: Job postings data is sourced from Lightcast. Currently this data is not available to all customers. We offer this as an upgrade.
Certification skills refer to skills associated with professional bodies, such as Chartered Accountants. A library of skills is maintained by Lightcast.
🔄 Update Cycle: Quarterly
Company Job Postings By Specialized Skill
🔗 Name on API: CompanyJobPostingsBySpecializedSkill
📥 Name on Download:
🗂️ Primary Data Source: Lightcast
📊 Secondary Data Source:
🔍 Description: Job postings data is sourced from Lightcast. Currently this data is not available to all customers. We offer this as an upgrade.
Specialised skills refer to cross-cutting technical skills and frameworks, such as marketing, or Agile methodolies. A library of skills is maintained by Lightcast.
🔄 Update Cycle: Quarterly
Company Job Postings By Software Skill
🔗 Name on API: CompanyJobPostingsBySoftwareSkill
📥 Name on Download:
🗂️ Primary Data Source: Lightcast
📊 Secondary Data Source:
🔍 Description: Job postings data is sourced from Lightcast. Currently this data is not available to all customers. We offer this as an upgrade.
Software skills refer to software, programming languages and methodologies, such as Python, Excel, or SQL. A library of skills is maintained by Lightcast.
🔄 Update Cycle: Quarterly
Estimated GVA
🔗 Name on API: EstimatedGVA
📥 Name on Download: BestEstimate_CurrentGVA
🗂️ Primary Data Source: ONS; BRES
📊 Secondary Data Source: Data City’s BestEstimateEmployees
🔍 Description: 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.
🌐 Knowledge Base: GVA data
🔄 Update Cycle: Bi-Monthly/Quarterly
Women Led Stats
🔗 Name on API: WomenLedStats
This is an object with the following fields. For each company we have identified the likely founders. We have used their declared title to assign them a gender.
We distinguish between founders that have founded a company, but are no longer active at the company and founders that are still active at the company.
🌐 Knowledge Base: Gender data
📑 Sub Fields
🔗 Name on API: InitialFemaleFounders
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Companies House
🔍 Description: The number of female founders at the time of founding.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: InitialMaleFounders
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Companies House
🔍 Description: The number of male founders at the time of founding.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TotalInitialFounders
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Companies House
🔍 Description: The number of founders at the time of founding.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ActiveFemaleFounders
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Companies House
🔍 Description: The number of female founders that are still active at the company.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ActiveMaleFounders
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Companies House
🔍 Description: The number of male founders that are still active at the company.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TotalActiveFounders
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Companies House
🔍 Description: The number of founders that are still active at the company.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ActiveMaleDirectors
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Companies House
🔍 Description: The number of active male directors.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: ActiveFemaleDirectors
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Companies House
🔍 Description: The number of active female directors.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: TotalActiveDirectors
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source: Companies House
🔍 Description: The number of active total directors.
🔄 Update Cycle: Monthly/Bi-Monthly
ESG RTIC
🔗 Name on API: ESG_RTIC
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: A boolean value indicating whether the company is in an ESG RTIC.
🔄 Update Cycle: Monthly/Bi-Monthly
Women Led
🔗 Name on API: WomenLed
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: A boolean value indicating whether the company is women led.
🌐 Knowledge Base: Gender data
🔄 Update Cycle: Monthly/Bi-Monthly
High Growth
🔗 Name on API: HighGrowth
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: A boolean value indicating whether the company is a high growth company.
🌐 Knowledge Base: Finding high growth companies
🔄 Update Cycle: Monthly/Bi-Monthly
Company Status
🔗 Name on API: CompanyStatus
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The company status as per Companies House.
🔄 Update Cycle: Monthly/Bi-Monthly
ESG Statements
🔗 Name on API: ESGStatementAnchors
This is an array of ESG statement anchors. Each anchor is a string that is found in the company’s website text.
📑 Sub Fields
🔗 Name on API: Domain
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The domain of the company’s website.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Anchor
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The ESG statement anchor.
🔄 Update Cycle: Monthly/Bi-Monthly
🔗 Name on API: Word
📥 Name on Download:
🗂️ Primary Data Source: TDC
📊 Secondary Data Source:
🔍 Description: The word in the ESG statement anchor which indicates the type of ESG statement.
🔄 Update Cycle: Monthly/Bi-Monthly