curl --request POST \
--url https://product-api.thedatacity.com/api/v2/companies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"returnCount": 20
}
'import requests
url = "https://product-api.thedatacity.com/api/v2/companies"
payload = { "returnCount": 20 }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({returnCount: 20})
};
fetch('https://product-api.thedatacity.com/api/v2/companies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://product-api.thedatacity.com/api/v2/companies",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'returnCount' => 20
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://product-api.thedatacity.com/api/v2/companies"
payload := strings.NewReader("{\n \"returnCount\": 20\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://product-api.thedatacity.com/api/v2/companies")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"returnCount\": 20\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://product-api.thedatacity.com/api/v2/companies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"returnCount\": 20\n}"
response = http.request(request)
puts response.read_body{
"companies": [
{
"AccountsOverdueByMoreThanAYear": true,
"BestEstimateEBITDA": 123,
"BestEstimateEmployees": 123,
"BestEstimateTurnover": 123,
"BestEstimateUKEmployees": 123,
"Bluesky": "<string>",
"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,
"LIKELY_AGENCY": true,
"LIKELY_AGENCY_PROBABILITY": 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
}
],
"OECDScaleup": true,
"SICs": [
"<string>"
],
"TurnoverEstimates": [
{
"Estimated": 123,
"Measure": 123,
"Year": 123
}
]
},
"CompanyImports": [
{}
],
"CompanyJobPostings": [
{
"MedianSalary": 123,
"Postings": 123,
"SOC4Code": "<string>",
"SOC4Name": "<string>"
}
],
"CompanyJobPostingsByLOTCodeOverTime": [
{
"AverageMedianSalary": 123,
"Count": 123,
"LOTCode": "<string>",
"Timestamp": 123
}
],
"CompanyJobPostingsByLot": [
{
"LotCode": "<string>",
"LotName": "<string>",
"MedianSalary": 123,
"Postings": 123
}
],
"CompanyJobPostingsBySOC4CodeOverTime": [
{
"AverageMedianSalary": 123,
"Count": 123,
"SOC4Code": "<string>",
"Timestamp": 123
}
],
"CompanyJobPostingsBySkill": [
{
"MedianPostingDuration": 123,
"SkillName": "<string>",
"UniquePostings": 123
}
],
"CompanyJobPostingsOverTime": {
"CompanyJobPostingsOverTimeByLot": [
{
"Count": 123,
"Timestamp": 123
}
],
"CompanyJobPostingsOverTimeBySoc4": [
{
"Count": 123,
"Timestamp": 123
}
]
},
"CompanyName": "<string>",
"CompanyNation": "<string>",
"CompanyNumber": "<string>",
"CompanyStatus": "<string>",
"ConsolidatedAccountsCompanyName": [
"<string>"
],
"ConsolidatedAccountsCompanyNumber": [
"<string>"
],
"CountryOfOrigin": "<string>",
"DealroomFunding": [
{
"CompanyId": "<string>",
"LastInvestmentDate": "2023-11-07T05:31:56Z",
"ParticipatingInvestorTypes": "<string>",
"ProviderCompanyName": "<string>",
"RoundAmount_GBP_Million": 123,
"RoundDate": "2023-11-07T05:31:56Z",
"RoundInvestorName": "<string>",
"RoundInvestorType": "<string>",
"RoundLeadInvestorName": "<string>",
"RoundType": "<string>",
"RoundVerified": 123,
"Spinout": 123,
"TotalInvestmentRaised_GBP_Million": 123
}
],
"DistinctBrandsInGroup": [
{}
],
"ESGStatementAnchors": [
{
"Anchor": "<string>",
"Domain": "<string>",
"Word": "<string>"
}
],
"ESG_RTIC": true,
"EmailAddresses": [
"<string>"
],
"EstimatedGVA": 123,
"EstimatedUKGVA": 123,
"Facebook": "<string>",
"GenderFoundedCategory": "<string>",
"GenderLedCategory": "<string>",
"GroupCompanyId": "<string>",
"GroupMembers": [
{}
],
"HasBeenAcquired": true,
"HasIPO": true,
"HasMadeAcquisitions": true,
"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>",
"Investment": [
{
"CompanyId": "<string>",
"LastInvestmentDate": "2023-11-07T05:31:56Z",
"ParticipatingInvestorTypes": "<string>",
"ProviderCompanyName": "<string>",
"RoundAmount_GBP_Million": 123,
"RoundDate": "2023-11-07T05:31:56Z",
"RoundInvestorName": "<string>",
"RoundInvestorType": "<string>",
"RoundLeadInvestorName": "<string>",
"RoundType": "<string>",
"RoundVerified": 123,
"Spinout": 123,
"TotalInvestmentRaised_GBP_Million": 123
}
],
"IsBCorp": true,
"IsLikelyAgency": true,
"IsLikelyCompanyFormationAgent": true,
"IsLikelySPV": true,
"IsWebsiteInheritedFromGroupStructure": true,
"LatestRoundAmount": 123,
"LatestRoundDate": "2023-11-07T05:31:56Z",
"LatestRoundType": "<string>",
"LatestRoundValuation": 123,
"LinkedCompanyNumbers": [
"<string>"
],
"Linkedin": "<string>",
"LocationDetails": [
{
"AssociatedAddress": "<string>",
"BestEstimateLocationEmployees": 123,
"BestEstimateLocationGVA": 123,
"BestEstimateLocationTurnover": 123,
"FoundOnWebpage": true,
"ITL1": "<string>",
"ITL1NM": "<string>",
"ITL2": "<string>",
"ITL2NM": "<string>",
"ITL3": "<string>",
"IsBlacklisted": true,
"IsOperatingAddress": true,
"IsSubsidiaryAddress": true,
"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>"
],
"NumberOfCurrentDirectors": 123,
"NumberOfCurrentOfficers": 123,
"OECDScaleup": true,
"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": [
{
"SIC_Code": "<string>",
"Score": 123
}
],
"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
}
],
"Spinout": true,
"SpinoutDate": "2023-12-25",
"SpinoutUniversities": [
"<string>"
],
"TonnesOfC02equivGHGPerYear": 123,
"Twitter": "<string>",
"URLMatchStats": {
"MatchedWebsite": "<string>",
"MatchedWebsiteConfidence": "<string>",
"MatchedWebsiteReasoning": [
"<string>"
],
"MatchedWebsiteScore": 123
},
"UltimateLinkedCompanyNumber": "<string>",
"UltimateParentNation": "<string>",
"UltimateUKParentCompanyNames": [
"<string>"
],
"UltimateUKParentCompanyNumbers": [
"<string>"
],
"UsesWWW": true,
"WomenLedStats": {
"ActiveFemaleDirectors": 123,
"ActiveFemaleFounders": 123,
"ActiveMaleDirectors": 123,
"ActiveMaleFounders": 123,
"ActiveUnknownGenderDirectors": 123,
"ActiveUnknownGenderFounders": 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>"
}
]
}
],
"insights": {
"BestEstimateTotalEmployeesAttributedToLocation": 123,
"BestEstimateTotalGVAAttributedToLocation": 123,
"BestEstimateTotalTurnoverAttributedToLocation": 123,
"TopInvestorsByRoundCount": [
{}
],
"TopInvestorsByValue": [
{}
]
},
"CompanyChanges": [
{}
],
"JobPostingsBySOC4Code": [
{}
],
"JobPostingsBySOC4Name": [
{}
],
"JobPostingsByLotName": [
{}
],
"AverageAdvertisedSalaryBySOC4Code": [
{}
],
"AverageAdvertisedSalaryBySOC4Name": [
{}
],
"AverageAdvertisedSalaryByLotName": [
{}
],
"JobPostingsBySkill": [
{}
],
"AveragePostingDurationBySkill": [
{}
],
"RTICJobPostings": [
{}
],
"RTICVerticalJobPostings": [
{}
],
"CICJobPostings": [
{}
],
"CICVerticalJobPostings": [
{}
],
"CompanyJobPostingsOverTimeBySOC4": [
{}
],
"CompanyJobPostingsOverTimeByLOT": [
{}
],
"JobPostingsByCommonSkill": [
{}
],
"AveragePostingDurationByCommonSkill": [
{}
],
"JobPostingsByCertificationsSkill": [
{}
],
"AveragePostingDurationByCertificationsSkill": [
{}
],
"JobPostingsBySpecializedSkill": [
{}
],
"AveragePostingDurationBySpecializedSkill": [
{}
],
"JobPostingInsights": [
{}
],
"JobPostingInsightsLOT": [
{}
]
}List companies by filter
curl --request POST \
--url https://product-api.thedatacity.com/api/v2/companies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"returnCount": 20
}
'import requests
url = "https://product-api.thedatacity.com/api/v2/companies"
payload = { "returnCount": 20 }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({returnCount: 20})
};
fetch('https://product-api.thedatacity.com/api/v2/companies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://product-api.thedatacity.com/api/v2/companies",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'returnCount' => 20
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://product-api.thedatacity.com/api/v2/companies"
payload := strings.NewReader("{\n \"returnCount\": 20\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://product-api.thedatacity.com/api/v2/companies")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"returnCount\": 20\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://product-api.thedatacity.com/api/v2/companies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"returnCount\": 20\n}"
response = http.request(request)
puts response.read_body{
"companies": [
{
"AccountsOverdueByMoreThanAYear": true,
"BestEstimateEBITDA": 123,
"BestEstimateEmployees": 123,
"BestEstimateTurnover": 123,
"BestEstimateUKEmployees": 123,
"Bluesky": "<string>",
"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,
"LIKELY_AGENCY": true,
"LIKELY_AGENCY_PROBABILITY": 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
}
],
"OECDScaleup": true,
"SICs": [
"<string>"
],
"TurnoverEstimates": [
{
"Estimated": 123,
"Measure": 123,
"Year": 123
}
]
},
"CompanyImports": [
{}
],
"CompanyJobPostings": [
{
"MedianSalary": 123,
"Postings": 123,
"SOC4Code": "<string>",
"SOC4Name": "<string>"
}
],
"CompanyJobPostingsByLOTCodeOverTime": [
{
"AverageMedianSalary": 123,
"Count": 123,
"LOTCode": "<string>",
"Timestamp": 123
}
],
"CompanyJobPostingsByLot": [
{
"LotCode": "<string>",
"LotName": "<string>",
"MedianSalary": 123,
"Postings": 123
}
],
"CompanyJobPostingsBySOC4CodeOverTime": [
{
"AverageMedianSalary": 123,
"Count": 123,
"SOC4Code": "<string>",
"Timestamp": 123
}
],
"CompanyJobPostingsBySkill": [
{
"MedianPostingDuration": 123,
"SkillName": "<string>",
"UniquePostings": 123
}
],
"CompanyJobPostingsOverTime": {
"CompanyJobPostingsOverTimeByLot": [
{
"Count": 123,
"Timestamp": 123
}
],
"CompanyJobPostingsOverTimeBySoc4": [
{
"Count": 123,
"Timestamp": 123
}
]
},
"CompanyName": "<string>",
"CompanyNation": "<string>",
"CompanyNumber": "<string>",
"CompanyStatus": "<string>",
"ConsolidatedAccountsCompanyName": [
"<string>"
],
"ConsolidatedAccountsCompanyNumber": [
"<string>"
],
"CountryOfOrigin": "<string>",
"DealroomFunding": [
{
"CompanyId": "<string>",
"LastInvestmentDate": "2023-11-07T05:31:56Z",
"ParticipatingInvestorTypes": "<string>",
"ProviderCompanyName": "<string>",
"RoundAmount_GBP_Million": 123,
"RoundDate": "2023-11-07T05:31:56Z",
"RoundInvestorName": "<string>",
"RoundInvestorType": "<string>",
"RoundLeadInvestorName": "<string>",
"RoundType": "<string>",
"RoundVerified": 123,
"Spinout": 123,
"TotalInvestmentRaised_GBP_Million": 123
}
],
"DistinctBrandsInGroup": [
{}
],
"ESGStatementAnchors": [
{
"Anchor": "<string>",
"Domain": "<string>",
"Word": "<string>"
}
],
"ESG_RTIC": true,
"EmailAddresses": [
"<string>"
],
"EstimatedGVA": 123,
"EstimatedUKGVA": 123,
"Facebook": "<string>",
"GenderFoundedCategory": "<string>",
"GenderLedCategory": "<string>",
"GroupCompanyId": "<string>",
"GroupMembers": [
{}
],
"HasBeenAcquired": true,
"HasIPO": true,
"HasMadeAcquisitions": true,
"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>",
"Investment": [
{
"CompanyId": "<string>",
"LastInvestmentDate": "2023-11-07T05:31:56Z",
"ParticipatingInvestorTypes": "<string>",
"ProviderCompanyName": "<string>",
"RoundAmount_GBP_Million": 123,
"RoundDate": "2023-11-07T05:31:56Z",
"RoundInvestorName": "<string>",
"RoundInvestorType": "<string>",
"RoundLeadInvestorName": "<string>",
"RoundType": "<string>",
"RoundVerified": 123,
"Spinout": 123,
"TotalInvestmentRaised_GBP_Million": 123
}
],
"IsBCorp": true,
"IsLikelyAgency": true,
"IsLikelyCompanyFormationAgent": true,
"IsLikelySPV": true,
"IsWebsiteInheritedFromGroupStructure": true,
"LatestRoundAmount": 123,
"LatestRoundDate": "2023-11-07T05:31:56Z",
"LatestRoundType": "<string>",
"LatestRoundValuation": 123,
"LinkedCompanyNumbers": [
"<string>"
],
"Linkedin": "<string>",
"LocationDetails": [
{
"AssociatedAddress": "<string>",
"BestEstimateLocationEmployees": 123,
"BestEstimateLocationGVA": 123,
"BestEstimateLocationTurnover": 123,
"FoundOnWebpage": true,
"ITL1": "<string>",
"ITL1NM": "<string>",
"ITL2": "<string>",
"ITL2NM": "<string>",
"ITL3": "<string>",
"IsBlacklisted": true,
"IsOperatingAddress": true,
"IsSubsidiaryAddress": true,
"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>"
],
"NumberOfCurrentDirectors": 123,
"NumberOfCurrentOfficers": 123,
"OECDScaleup": true,
"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": [
{
"SIC_Code": "<string>",
"Score": 123
}
],
"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
}
],
"Spinout": true,
"SpinoutDate": "2023-12-25",
"SpinoutUniversities": [
"<string>"
],
"TonnesOfC02equivGHGPerYear": 123,
"Twitter": "<string>",
"URLMatchStats": {
"MatchedWebsite": "<string>",
"MatchedWebsiteConfidence": "<string>",
"MatchedWebsiteReasoning": [
"<string>"
],
"MatchedWebsiteScore": 123
},
"UltimateLinkedCompanyNumber": "<string>",
"UltimateParentNation": "<string>",
"UltimateUKParentCompanyNames": [
"<string>"
],
"UltimateUKParentCompanyNumbers": [
"<string>"
],
"UsesWWW": true,
"WomenLedStats": {
"ActiveFemaleDirectors": 123,
"ActiveFemaleFounders": 123,
"ActiveMaleDirectors": 123,
"ActiveMaleFounders": 123,
"ActiveUnknownGenderDirectors": 123,
"ActiveUnknownGenderFounders": 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>"
}
]
}
],
"insights": {
"BestEstimateTotalEmployeesAttributedToLocation": 123,
"BestEstimateTotalGVAAttributedToLocation": 123,
"BestEstimateTotalTurnoverAttributedToLocation": 123,
"TopInvestorsByRoundCount": [
{}
],
"TopInvestorsByValue": [
{}
]
},
"CompanyChanges": [
{}
],
"JobPostingsBySOC4Code": [
{}
],
"JobPostingsBySOC4Name": [
{}
],
"JobPostingsByLotName": [
{}
],
"AverageAdvertisedSalaryBySOC4Code": [
{}
],
"AverageAdvertisedSalaryBySOC4Name": [
{}
],
"AverageAdvertisedSalaryByLotName": [
{}
],
"JobPostingsBySkill": [
{}
],
"AveragePostingDurationBySkill": [
{}
],
"RTICJobPostings": [
{}
],
"RTICVerticalJobPostings": [
{}
],
"CICJobPostings": [
{}
],
"CICVerticalJobPostings": [
{}
],
"CompanyJobPostingsOverTimeBySOC4": [
{}
],
"CompanyJobPostingsOverTimeByLOT": [
{}
],
"JobPostingsByCommonSkill": [
{}
],
"AveragePostingDurationByCommonSkill": [
{}
],
"JobPostingsByCertificationsSkill": [
{}
],
"AveragePostingDurationByCertificationsSkill": [
{}
],
"JobPostingsBySpecializedSkill": [
{}
],
"AveragePostingDurationBySpecializedSkill": [
{}
],
"JobPostingInsights": [
{}
],
"JobPostingInsightsLOT": [
{}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
When true, include dashboard-style insights in the filtered-companies response.
Comma-separated company fields to include per row (sparse fieldset). Unknown fields return 400 from the upstream API.
"CompanyNumber,CompanyName,BestEstimateEmployees"
Comma-separated predefined field groups (union with fields[companies]).
"identity"
Body
Composed of shared filter criteria plus extended filter fields. Query parameter insights is documented on each operation. Full field list is under Schema; this example is intentionally minimal.
Selected RTIC codes, such as RTIC0052 (a sector) or RTIC009801 (a vertical inside a sector). Use codes from GET /v2/rtics, not sector names: a name such as FinTech matches no companies.
User CIC codes.
Inline company numbers (typically up to ~50k). Use a low returnCount for huge portfolios so the JSON response stays small — with ?insights=true, insights still aggregates the full matched set.
Use instead of CompanyNumbers when the list is too large to send inline (roughly >50k) — upload via POST /v2/company-number-sets first.
Required when using a large uploaded company number set.
Nested FiltersInPostRequestBody payload.
Product API pre-filter selector (upstream-defined).
Company numbers to explicitly include (upstream Yes list).
Company numbers to explicitly exclude (upstream No list).
Number of cross-validation or sampling folds for upstream analysis workflows.
Gender-leadership filters: one boolean per mutually-exclusive category, for directors (…Directed) and founders (…Founded). Ticking several within an axis is a union (OR); the two axes combine with AND. Replaces the pre-2026 overlapping flags (WomenLed, MenLedIncludingMixed, etc.), which are no longer accepted.
Minimum total investment, same currency/units as upstream.
Maximum total investment, same currency/units as upstream.
Whether to include companies with no investment amount.
Investment round types to match.
Obsolete alias for MinInvestment.
Obsolete alias for MaxInvestment.
Obsolete alias for IncludeUnknownInvestment.
Obsolete alias for InvestmentRoundType.
Obsolete alias for InvestmentRoundDateFrom.
Obsolete alias for InvestmentRoundDateTo.
Obsolete alias for InvestmentLatestRoundType.
Removes a company when its consolidated-accounts parent is an active company in the same result set. The check runs after all other filters, so narrowing them (for example to one RTIC) can bring a subsidiary back when its parent no longer matches.
Lightcast LOT (level of title) occupation codes.
SOC (Standard Occupational Classification) codes for job postings filter.
Page size (default 20). Consumed by this API gateway; not forwarded as part of the filter object. Must be camelCase: ReturnCount is ignored.
Pagination offset (number of rows to skip).
Score or relevance threshold for ranked or similarity results (upstream-defined scale).
Alternative name for cics. Used only when cics is missing: if you send both, cics is used.
Alternative name for rtics. Used only when rtics is missing: if you send both, rtics is used. Values are RTIC codes from GET /v2/rtics, not sector names.
UK SIC 2007 industry codes.
RSIC (Real-Time SIC) codes: UK SIC codes that correct, replace or fill missing Companies House SICs.
Industry Standard (IS) classification codes used by the product.
SIC high-level unit or grouping codes (aggregated SIC bands).
UK ITL1 (international territorial level 1) region codes.
UK ITL2 sub-region codes.
Maximum estimated employee count (modeled estimate, not only filed headcount).
Minimum estimated employee count (modeled estimate).
Maximum estimated turnover (modeled estimate).
Minimum estimated turnover (modeled estimate).
Minimum employees from filed or normalised accounts.
Maximum employees from filed or normalised accounts.
Minimum turnover (TURN): revenue / sales per filed accounts.
Maximum turnover (TURN): revenue / sales per filed accounts.
Minimum profit before tax (pre-tax profit) from filed accounts. Same currency/units as upstream.
Maximum profit before tax (pre-tax profit) from filed accounts.
Minimum profit after tax from filed accounts.
Maximum profit after tax from filed accounts.
Minimum cash or cash-like balance sheet line (filed accounts).
Maximum cash or cash-like balance sheet line (filed accounts).
Minimum total current assets (TCA).
Maximum total current assets (TCA).
Minimum total assets (TA).
Maximum total assets (TA).
Minimum total liabilities (TL).
Maximum total liabilities (TL).
Minimum shareholders funds / equity (SF).
Maximum shareholders funds / equity (SF).
Minimum net assets (NA).
Maximum net assets (NA).
Minimum net worth (NW), as defined in upstream normalised accounts.
Maximum net worth (NW), as defined in upstream normalised accounts.
Minimum export value (trade statistics field; units per upstream).
Maximum export value (trade statistics field; units per upstream).
Minimum EBITDA where available in upstream financials.
Maximum EBITDA where available in upstream financials.
Minimum innovation score or index (product-specific metric).
Minimum total Innovate UK grant funding (or equivalent normalised amount).
Maximum total Innovate UK grant funding (or equivalent normalised amount).
RTIC codes to exclude. Removes every company classified in any of these sectors or their verticals (e.g. RTIC0087 also covers RTIC008701). Without the Defence premium feature, Defence codes (RTIC0096 and its verticals) are ignored.
Industrial Strategy sector codes (IS-8 scheme) to exclude. Removes every company with any of these codes or their sub-sector codes (e.g. IS05 also covers IS0501). Without the Defence premium feature, Defence codes (IS04 and its sub-sectors) are ignored.
Response
Filtered companies from the product API.
Filtered / classify list response from the product API. Top-level keys use camelCase JSON (companies, insights); the ListInsights component schema describes the shape of the insights object, not its JSON key name.
Company objects (ClassifiedCompany) or plain company number strings when ReturnCompanyIDsOnly is set.
Generated from The Data City data dictionary (schema ClassifiedCompany, version 1.0). See https://docs.thedatacity.com/data-dictionary/
Show child attributes
Show child attributes
Present when the insights query parameter is true and the token supports it. Field names inside this object are PascalCase (see data dictionary / ListInsights schema).
Show child attributes
Show child attributes
Omitted without companies:changes.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.
Omitted without lightcast:read.