Skip to main content
POST
/
v2
/
companies
/
batch
Get multiple company details
curl --request POST \
  --url https://product-api.thedatacity.com/api/v2/companies/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '[
  "10958787"
]'
[
  {
    "BestEstimateEBITDA": 123,
    "BestEstimateEmployees": 123,
    "BestEstimateTurnover": 123,
    "BestEstimateUKEmployees": 123,
    "CICs": [
      {}
    ],
    "CompanyCategory": "<string>",
    "CompanyDescription": "<string>",
    "CompanyExports": [
      {}
    ],
    "CompanyFinancials_CreditSafe": [
      {
        "ACCOUNTANT_NAME": "<string>",
        "ACCOUNTS_FORMAT": "<string>",
        "AMORTISATION_OF_INTANGIBLES": 123,
        "AUDITORS": "<string>",
        "BANK_OVERDRAFT": 123,
        "CASH": 123,
        "CONSOLIDATED_ACS": true,
        "CREDITORS": 123,
        "CURRENCY": "<string>",
        "DEBTORS": 123,
        "DEBTORS_DUE_AFTER_ONE_YEAR": 123,
        "DECREASE_OR_INCREASE_IN_CASH": 123,
        "DEPRECIATION_OF_TANGIBLES": 123,
        "EBITDA": 123,
        "EMPLOYEES_ANOMALOUS": true,
        "EMPLOYEES_ANOMALOUS_PROBABILITY": 123,
        "EXPORT": 123,
        "GROUP_DEBTORS": 123,
        "MADE_FROM_DATE": "2023-11-07T05:31:56Z",
        "MADE_UPTO_DATE": "2023-11-07T05:31:56Z",
        "NET_ASSETS": 123,
        "NET_WORTH": 123,
        "NUMBER_OF_EMPLOYEES": 123,
        "NUM_OF_MONTHS": 123,
        "OPERATING_PROFIT": 123,
        "PRE_TAX_PROFIT": 123,
        "PROFIT_AFTER_TAX": 123,
        "SHAREHOLDER_FUNDS": 123,
        "TOTAL_ASSETS": 123,
        "TOTAL_CURRENT_ASSETS": 123,
        "TOTAL_CURRENT_LIABILITIES": 123,
        "TOTAL_LIABILITIES": 123,
        "TRADE_DEBTORS": 123,
        "TURNOVER": 123,
        "TURNOVER_ANOMALOUS": true,
        "TURNOVER_ANOMALOUS_PROBABILITY": 123,
        "WAGES_AND_SALARIES": 123,
        "YEAR": 123
      }
    ],
    "CompanyGrowthTrends": {
      "BestEstimateCurrentEmployees": 123,
      "BestEstimateCurrentTurnover": 123,
      "BestEstimateEmployeeGrowthPercentagePerYear": 123,
      "BestEstimateGrowthPercentagePerYear": 123,
      "BestEstimateTurnoverGrowthPercentagePerYear": 123,
      "BestEstimatedTurnoverToEmployeeRatio": 123,
      "CompanyAgeInDays": 123,
      "CompanySizeEstimate": "<string>",
      "EmploymentEstimates": [
        {
          "Estimated": 123,
          "Measure": 123,
          "Year": 123
        }
      ],
      "SICs": [
        "<string>"
      ],
      "TurnoverEstimates": [
        {
          "Estimated": 123,
          "Measure": 123,
          "Year": 123
        }
      ]
    },
    "CompanyImports": [
      {}
    ],
    "CompanyJobPostings": [
      {
        "MedianSalary": 123,
        "Postings": 123,
        "SOC4Code": "<string>",
        "SOC4Name": "<string>"
      }
    ],
    "CompanyJobPostingsByLot": [
      {
        "LotCode": "<string>",
        "LotName": "<string>",
        "MedianSalary": 123,
        "Postings": 123
      }
    ],
    "CompanyJobPostingsBySkill": [
      {
        "MedianPostingDuration": 123,
        "SkillName": "<string>",
        "UniquePostings": 123
      }
    ],
    "CompanyName": "<string>",
    "CompanyNation": "<string>",
    "CompanyNumber": "<string>",
    "CompanyStatus": "<string>",
    "ConsolidatedAccountsCompanyName": [
      "<string>"
    ],
    "ConsolidatedAccountsCompanyNumber": [
      "<string>"
    ],
    "CountryOfOrigin": "<string>",
    "DealroomFunding": [
      {
        "DealroomID": "<string>",
        "DealroomName": "<string>",
        "LastFundingDate": "2023-11-07T05:31:56Z",
        "RoundAmount": 123,
        "RoundDate": "2023-11-07T05:31:56Z",
        "RoundInvestorName": "<string>",
        "RoundInvestorType": "<string>",
        "RoundType": "<string>",
        "RoundVerified": 123,
        "Spinout": 123,
        "TotalFundingRaised_GBP_Million": 123
      }
    ],
    "DistinctBrandsInGroup": [
      {}
    ],
    "ESGStatementAnchors": [
      {
        "Anchor": "<string>",
        "Domain": "<string>",
        "Word": "<string>"
      }
    ],
    "ESG_RTIC": true,
    "EmailAddresses": [
      "<string>"
    ],
    "EstimatedGVA": 123,
    "EstimatedUKGVA": 123,
    "Facebook": "<string>",
    "HighGrowth": true,
    "Homepage_domain": "<string>",
    "IS8Codes": [
      {
        "ISCode": "<string>",
        "ISCodeName": "<string>",
        "ISVerticalCode": "<string>",
        "ISVerticalName": "<string>"
      }
    ],
    "IncorporationDate": "2023-12-25",
    "InnovateUKFunding": [
      {
        "ActualSpendtoDate": 123,
        "ApplicationNumber": "<string>",
        "AwardOffered": 123,
        "CompetitionReference": "<string>",
        "CompetitionTitle": "<string>",
        "CompetitionYear": 123,
        "EnterpriseSize": "<string>",
        "IndustrialStrategyChallengeFundISCF": "<string>",
        "InnovateUKProductType": "<string>",
        "IsLeadParticipant": "<string>",
        "ParticipantName": "<string>",
        "ParticipantWithdrawnFromProject": "<string>",
        "Postcode": "<string>",
        "ProgrammeTitle": "<string>",
        "ProjectEndDate": "2023-11-07T05:31:56Z",
        "ProjectNumber": "<string>",
        "ProjectStartDate": "2023-11-07T05:31:56Z",
        "ProjectStatus": "<string>",
        "ProjectTitle": "<string>",
        "PublicDescription": "<string>",
        "Sector": "<string>",
        "TotalCosts": 123
      }
    ],
    "InnovationKeywords": [
      "<string>"
    ],
    "InnovationScore": 123,
    "Instagram": "<string>",
    "Linkedin": "<string>",
    "LocationDetails": [
      {
        "AssociatedAddress": "<string>",
        "BestEstimateLocationEmployees": 123,
        "BestEstimateLocationGVA": 123,
        "BestEstimateLocationTurnover": 123,
        "FoundOnWebpage": true,
        "ITL1": "<string>",
        "ITL1NM": "<string>",
        "ITL2": "<string>",
        "ITL2NM": "<string>",
        "LAcode": "<string>",
        "LAname": "<string>",
        "LSOA": "<string>",
        "Latitude": 123,
        "Longitude": 123,
        "MSOA": "<string>",
        "OECDFUACorePlusCommuting": "<string>",
        "Postcode": "<string>",
        "Postcode_withspaces": "<string>",
        "RegisteredPostcode": true,
        "StrategicAuthorityCode": "<string>",
        "StrategicAuthorityName": "<string>",
        "UKConstituency": "<string>"
      }
    ],
    "ManufacturingKeywords": [
      "<string>"
    ],
    "Officers": [
      {
        "AddressLine1": "<string>",
        "AddressLine2": "<string>",
        "Appointedon": "2023-12-25",
        "Careof": "<string>",
        "Country": "<string>",
        "County": "<string>",
        "DOB": "2023-12-25",
        "Forenames": "<string>",
        "Honours": "<string>",
        "Nationality": "<string>",
        "Occupation": "<string>",
        "PersonNumber": "<string>",
        "PostTown": "<string>",
        "ResignationDate": "2023-12-25",
        "Role": "<string>",
        "Surname": "<string>",
        "Title": "<string>",
        "UsualResidentialCountry": "<string>"
      }
    ],
    "ParentNation": "<string>",
    "PhoneNumbers": [
      "<string>"
    ],
    "RSICs": [
      {
        "Id": 123,
        "SIC_Code": "<string>",
        "Score": 123,
        "True_RSIC": true
      }
    ],
    "RTICs": [
      {}
    ],
    "RegisteredAddress": "<string>",
    "RegisteredPostcode": "<string>",
    "SICHLUs": [
      "<string>"
    ],
    "SICs": [
      "<string>"
    ],
    "SectorKeywords": [
      "<string>"
    ],
    "SimilarCompanies": [
      {
        "CompanyOne": "<string>",
        "CompanyTwo": "<string>",
        "Similarity": 123
      }
    ],
    "SimilarCompositeCompanies": [
      {
        "CompanyOne": "<string>",
        "CompanyTwo": "<string>",
        "Similarity": 123
      }
    ],
    "TonnesOfC02equivGHGPerYear": 123,
    "Twitter": "<string>",
    "URLMatchStats": {
      "MatchedWebsite": "<string>",
      "MatchedWebsiteConfidence": "<string>",
      "MatchedWebsiteReasoning": [
        "<string>"
      ],
      "MatchedWebsiteScore": 123,
      "MatchedWebsiteSources": [
        "<string>"
      ]
    },
    "UltimateParentNation": "<string>",
    "UltimateUKParentCompanyNames": [
      "<string>"
    ],
    "UltimateUKParentCompanyNumbers": [
      "<string>"
    ],
    "WomenLed": true,
    "WomenLedStats": {
      "ActiveFemaleDirectors": 123,
      "ActiveFemaleFounders": 123,
      "ActiveMaleDirectors": 123,
      "ActiveMaleFounders": 123,
      "InitialFemaleFounders": 123,
      "InitialMaleFounders": 123,
      "TotalActiveDirectors": 123,
      "TotalActiveFounders": 123,
      "TotalInitialFounders": 123
    },
    "Youtube": "<string>",
    "_360GivingFunding": [
      {
        "ImpactCategory": "<string>",
        "Primaryissue": "<string>",
        "amountAwarded": 123,
        "awardDate": "2023-11-07T05:31:56Z",
        "currency": "<string>",
        "description": "<string>",
        "funderName": "<string>",
        "grantProgrammeTitle": "<string>",
        "recipientName": "<string>",
        "recipientURL": "<string>",
        "title": "<string>"
      }
    ]
  }
]

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
includeSimilarCompanies
boolean

When true, response includes SimilarCompanies.

​
includeSimilarCompositeCompanies
boolean

When true, response includes SimilarCompositeCompanies.

​
includeChangelog
boolean

When true, response includes CompanyChanges.

Body

application/json
Maximum array length: 1000
Example:
["10958787"]

Response

Batch of company detail objects.

​
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 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.

​
BestEstimateUKEmployees
integer<int64>

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

​
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[]

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.

​
CompanyGrowthTrends
object

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[]

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 s…

​
CompanyJobPostingsByLot
object[]

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 keywor…

​
CompanyJobPostingsBySkill
object[]

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 s…

​
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[]

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.

​
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.

​
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.

​
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.

​
Officers
object[]

These are officers as per Companies House. E.g. https://find-and-update.company-information.service.gov.uk/company/10958787/officers

​
ParentNation
string

The nation of the parent company.

​
PhoneNumbers
string[]

CreditSafe provide TDC with CTPS approved phone numbers. Phone numbers are extracted from the website text.

​
RSICs
object[]

Real-Time SIC (RSIC) rows (SIC_Code, Score, Id, True_RSIC, …). No display name here — join SIC_Code to metadata from GET /v2/filters (see RSIC schema description).

​
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.

​
RegisteredPostcode
string

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

​
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.

​
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/

​
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.

​
WomenLed
boolean

A boolean value indicating whether the company is women led.

​
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 June 8, 2026