Skip to main content
POST
/
v2
/
companies
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 '
{
  "rtics": [
    "<string>"
  ],
  "cics": [
    "<string>"
  ],
  "CompanyNumbers": [
    "<string>"
  ],
  "CompanyNumberSetId": "<string>",
  "AllowLargeAnalysis": true,
  "PreFilter": {},
  "PreFilterType": "<string>",
  "IncorporationDateFrom": "2023-12-25",
  "IncorporationDateTo": "2023-12-25",
  "Yes": [
    "<string>"
  ],
  "No": [
    "<string>"
  ],
  "InsightsFlag": true,
  "CustomGeographyGeoJSON": "<string>",
  "CustomGeographyWKT": "<string>",
  "ReturnCompanyIDsOnly": true,
  "ReturnBasicCompanyDetailsOnly": true,
  "NumberOfFolds": 123,
  "WomenLedIncludingMixed": true,
  "MenLedIncludingMixed": true,
  "WomenLed": true,
  "MenLed": true,
  "MixedGenderLed": true,
  "WomenFounded": true,
  "OnlyWomenFounded": true,
  "MenFounded": true,
  "OnlyMenFounded": true,
  "MixedGenderFounded": true,
  "HasExported": true,
  "HasImported": true,
  "AnyActiveFounder": true,
  "MaxGrowthRate": 123,
  "MinGrowthRate": 123,
  "ManuallyInclude": [
    "<string>"
  ],
  "ManuallyExclude": [
    "<string>"
  ],
  "ExploreManuallyInclude": [
    "<string>"
  ],
  "ExploreManuallyExclude": [
    "<string>"
  ],
  "FieldEditsSource": [
    "<string>"
  ],
  "MinDealroom": 123,
  "MaxDealroom": 123,
  "IncludeUnknownDealroom": true,
  "DealroomRoundType": [
    "<string>"
  ],
  "DealroomRoundDateFrom": "2023-11-07T05:31:56Z",
  "DealroomRoundDateTo": "2023-11-07T05:31:56Z",
  "DealroomLatestRoundType": true,
  "ExcludeOutliers": true,
  "RemoveSubsidiaryCompanies": true,
  "CompanyStatus": "<string>",
  "CompanyStatusList": [
    "<string>"
  ],
  "ViewOutliers": true,
  "ExcludeForeignCompanies": true,
  "OECDScaleup": true,
  "IsSpinOut": true,
  "HasLightcastData": true,
  "HasProfilesData": true,
  "SelectedLOTCodes": [
    "<string>"
  ],
  "SelectedSOCCodes": [
    "<string>"
  ],
  "JobPostingsFromDate": "2023-11-07T05:31:56Z",
  "JobPostingsToDate": "2023-11-07T05:31:56Z",
  "ReturnCount": 123,
  "Skip": 123,
  "Cutoff": 123,
  "ContainsKeyword": "<string>",
  "DoesNotContainKeyword": "<string>",
  "CompanyName": "<string>",
  "OrderBy": "<string>",
  "Order": "<string>",
  "DownloadFormat": "<string>",
  "DownloadFields": [
    "<string>"
  ],
  "OnlyCompaniesWithWebsites": true,
  "OnlyCompaniesWithRegisteredAddressWithinFilterLocation": true,
  "OnlyCompaniesWithoutRegisteredAddressWithinFilterLocation": true,
  "CalculateInsightsBasedOnlyOnRegisteredAddresses": true,
  "UserCICs": [
    "<string>"
  ],
  "SelectedRTICs": [
    "<string>"
  ],
  "SelectedSICs": [
    "<string>"
  ],
  "SelectedRSICs": [
    "<string>"
  ],
  "SelectedISCodes": [
    "<string>"
  ],
  "SelectedExportCodes": [
    "<string>"
  ],
  "TradeFromDate": "2023-11-07T05:31:56Z",
  "TradeToDate": "2023-11-07T05:31:56Z",
  "SelectedImportCodes": [
    "<string>"
  ],
  "SelectedSICHLUs": [
    "<string>"
  ],
  "SelectedCategories": [
    "<string>"
  ],
  "SelectedCities": [
    "<string>"
  ],
  "SelectedLANames": [
    "<string>"
  ],
  "SelectedLACodes": [
    "<string>"
  ],
  "SelectedCountriesOfOrigin": [
    "<string>"
  ],
  "SelectedITL1Regions": [
    "<string>"
  ],
  "SelectedITL2Regions": [
    "<string>"
  ],
  "SelectedUKConstituencies": [
    "<string>"
  ],
  "SelectedUltimateParentNations": [
    "<string>"
  ],
  "SelectedStrategicAuthorityCodes": [
    "<string>"
  ],
  "SelectedStrategicAuthorityNames": [
    "<string>"
  ],
  "SelectedCompanySizes": [
    "<string>"
  ],
  "SelectedWebsiteMatchConfidence": 123,
  "NotKnownToBeForeign": true,
  "KnownToBeForeign": true,
  "ESTEMPLOYEES_MAX": 123,
  "ESTEMPLOYEES_MIN": 123,
  "ESTTURNOVER_MAX": 123,
  "ESTTURNOVER_MIN": 123,
  "EMPLOYEES_MIN": 123,
  "EMPLOYEES_MAX": 123,
  "TURN_MIN": 123,
  "TURN_MAX": 123,
  "PTP_MIN": 123,
  "PTP_MAX": 123,
  "PAT_MIN": 123,
  "PAT_MAX": 123,
  "CASH_MIN": 123,
  "CASH_MAX": 123,
  "TCA_MIN": 123,
  "TCA_MAX": 123,
  "TA_MIN": 123,
  "TA_MAX": 123,
  "TL_MIN": 123,
  "TL_MAX": 123,
  "SF_MIN": 123,
  "SF_MAX": 123,
  "NA_MIN": 123,
  "NA_MAX": 123,
  "NW_MIN": 123,
  "NW_MAX": 123,
  "EXPORT_MIN": 123,
  "EXPORT_MAX": 123,
  "EBITDA_MIN": 123,
  "EBITDA_MAX": 123,
  "Innovation_MIN": 123,
  "InnovateUKFunding_MIN": 123,
  "InnovateUKFunding_MAX": 123,
  "OnlyManufacturingCompanies": true,
  "OnlyESGCompanies": true,
  "IsLikelyDistinctBrand": true,
  "SearchPostcode": "<string>",
  "SearchPostcodeRadius": 123,
  "SelectedPostcodeOutcodes": [
    "<string>"
  ],
  "InstantSearchString": "<string>",
  "MinPoints": 123,
  "MinClusterSize": 123,
  "ClusterCount": 123,
  "OutlierPercentage": 123,
  "ClusteringMethod": "<string>",
  "TrimClustersBelowPercentage": "<string>",
  "ChangelogStartDate": "2023-11-07T05:31:56Z",
  "UseSemanticSearch": true,
  "RTICsToExclude": [
    "<string>"
  ],
  "IS8CodesToExclude": [
    "<string>"
  ]
}
'
{
  "companies": [
    {
      "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>"
        }
      ]
    }
  ],
  "insights": {
    "BestEstimateTotalEmployeesAttributedToLocation": 123,
    "BestEstimateTotalGVAAttributedToLocation": 123,
    "BestEstimateTotalTurnoverAttributedToLocation": 123
  },
  "CompanyChanges": [
    {}
  ],
  "JobPostingsBySOC4Code": [
    {}
  ],
  "JobPostingsBySOC4Name": [
    {}
  ],
  "JobPostingsByLotName": [
    {}
  ],
  "AverageAdvertisedSalaryBySOC4Code": [
    {}
  ],
  "AverageAdvertisedSalaryBySOC4Name": [
    {}
  ],
  "AverageAdvertisedSalaryByLotName": [
    {}
  ],
  "JobPostingsBySkill": [
    {}
  ],
  "AveragePostingDurationBySkill": [
    {}
  ],
  "RTICJobPostings": [
    {}
  ],
  "RTICVerticalJobPostings": [
    {}
  ],
  "CICJobPostings": [
    {}
  ],
  "CICVerticalJobPostings": [
    {}
  ],
  "CompanyJobPostingsOverTimeBySOC4": [
    {}
  ],
  "CompanyJobPostingsOverTimeByLOT": [
    {}
  ],
  "JobPostingsByCommonSkill": [
    {}
  ],
  "AveragePostingDurationByCommonSkill": [
    {}
  ],
  "JobPostingsByCertificationsSkill": [
    {}
  ],
  "AveragePostingDurationByCertificationsSkill": [
    {}
  ],
  "JobPostingsBySpecializedSkill": [
    {}
  ],
  "AveragePostingDurationBySpecializedSkill": [
    {}
  ],
  "JobPostingInsights": [
    {}
  ],
  "JobPostingInsightsLOT": [
    {}
  ],
  "TotalDealroomFunding": [
    {}
  ],
  "CompaniesWithDealroomFunding": [
    {}
  ],
  "DealroomAverageFundingSizePerYear": [
    {}
  ],
  "DealroomFundingByYear": [
    {}
  ],
  "DealroomFundingRoundsByYear": [
    {}
  ],
  "RTICDealroomFunding": [
    {}
  ],
  "CICDealroomFunding": [
    {}
  ],
  "RTICVerticalDealroomFunding": [
    {}
  ],
  "CICVerticalDealroomFunding": [
    {}
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
insights
boolean

When true, include dashboard-style insights in the filtered-companies response.

Body

application/json

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.

​
rtics
string[]

Selected RTIC codes.

​
cics
string[]

User CIC codes.

​
CompanyNumbers
string[]

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.

​
CompanyNumberSetId
string

Use instead of CompanyNumbers when the list is too large to send inline (roughly >50k) — upload via POST /v2/company-number-sets first.

​
AllowLargeAnalysis
boolean

Required when using a large uploaded company number set.

​
PreFilter
object

Nested FiltersInPostRequestBody payload.

​
PreFilterType
string

Product API pre-filter selector (upstream-defined).

​
IncorporationDateFrom
string<date> | null
​
IncorporationDateTo
string<date> | null
​
Yes
string[]

Company numbers to explicitly include (upstream Yes list).

​
No
string[]

Company numbers to explicitly exclude (upstream No list).

​
InsightsFlag
boolean | null
​
CustomGeographyGeoJSON
string
​
CustomGeographyWKT
string
​
ReturnCompanyIDsOnly
boolean
​
ReturnBasicCompanyDetailsOnly
boolean
​
NumberOfFolds
integer

Number of cross-validation or sampling folds for upstream analysis workflows.

​
WomenLedIncludingMixed
boolean
​
MenLedIncludingMixed
boolean
​
WomenLed
boolean
​
MenLed
boolean
​
MixedGenderLed
boolean
​
WomenFounded
boolean
​
OnlyWomenFounded
boolean
​
MenFounded
boolean
​
OnlyMenFounded
boolean
​
MixedGenderFounded
boolean
​
HasExported
boolean
​
HasImported
boolean
​
AnyActiveFounder
boolean
​
MaxGrowthRate
number | null
​
MinGrowthRate
number | null
​
ManuallyInclude
string[]
​
ManuallyExclude
string[]
​
ExploreManuallyInclude
string[]
​
ExploreManuallyExclude
string[]
​
FieldEditsSource
string[]
​
MinDealroom
number | null

Minimum total funding (Dealroom), same currency/units as upstream.

​
MaxDealroom
number | null

Maximum total funding (Dealroom), same currency/units as upstream.

​
IncludeUnknownDealroom
boolean | null

Whether to include companies with no Dealroom funding amount.

​
DealroomRoundType
string[]

Funding round types to match (Dealroom taxonomy).

​
DealroomRoundDateFrom
string<date-time> | null
​
DealroomRoundDateTo
string<date-time> | null
​
DealroomLatestRoundType
boolean | null
​
ExcludeOutliers
boolean | null
​
RemoveSubsidiaryCompanies
boolean | null
​
CompanyStatus
string
​
CompanyStatusList
string[]
​
ViewOutliers
boolean | null
​
ExcludeForeignCompanies
boolean | null
​
OECDScaleup
boolean | null
​
IsSpinOut
boolean | null
​
HasLightcastData
boolean | null
​
HasProfilesData
boolean | null
​
SelectedLOTCodes
string[]

Lightcast LOT (level of title) occupation codes.

​
SelectedSOCCodes
string[]

SOC (Standard Occupational Classification) codes for job postings filter.

​
JobPostingsFromDate
string<date-time> | null
​
JobPostingsToDate
string<date-time> | null
​
ReturnCount
integer | null

Consumed by this API gateway; not forwarded as part of the filter object.

​
Skip
integer

Pagination offset (number of rows to skip).

​
Cutoff
number | null

Score or relevance threshold for ranked or similarity results (upstream-defined scale).

​
ContainsKeyword
string
​
DoesNotContainKeyword
string
​
CompanyName
string
​
OrderBy
string
​
Order
string
​
DownloadFormat
string
​
DownloadFields
string[]
​
OnlyCompaniesWithWebsites
boolean
​
OnlyCompaniesWithRegisteredAddressWithinFilterLocation
boolean
​
OnlyCompaniesWithoutRegisteredAddressWithinFilterLocation
boolean
​
CalculateInsightsBasedOnlyOnRegisteredAddresses
boolean
​
UserCICs
string[]

Same as JSON cics when sent via this gateway.

​
SelectedRTICs
string[]

Same as JSON rtics when sent via this gateway.

​
SelectedSICs
string[]

UK SIC 2007 industry codes.

​
SelectedRSICs
string[]

RSIC (Real-Time SIC) codes: UK SIC codes that correct, replace or fill missing Companies House SICs.

​
SelectedISCodes
string[]

Industry Standard (IS) classification codes used by the product.

​
SelectedExportCodes
string[]
​
TradeFromDate
string<date-time> | null
​
TradeToDate
string<date-time> | null
​
SelectedImportCodes
string[]
​
SelectedSICHLUs
string[]

SIC high-level unit or grouping codes (aggregated SIC bands).

​
SelectedCategories
string[]
​
SelectedCities
string[]
​
SelectedLANames
string[]
​
SelectedLACodes
string[]
​
SelectedCountriesOfOrigin
string[]
​
SelectedITL1Regions
string[]

UK ITL1 (international territorial level 1) region codes.

​
SelectedITL2Regions
string[]

UK ITL2 sub-region codes.

​
SelectedUKConstituencies
string[]
​
SelectedUltimateParentNations
string[]
​
SelectedStrategicAuthorityCodes
string[]
​
SelectedStrategicAuthorityNames
string[]
​
SelectedCompanySizes
string[]
​
SelectedWebsiteMatchConfidence
integer | null
​
NotKnownToBeForeign
boolean | null
​
KnownToBeForeign
boolean | null
​
ESTEMPLOYEES_MAX
integer<int64> | null

Maximum estimated employee count (modeled estimate, not only filed headcount).

​
ESTEMPLOYEES_MIN
integer<int64> | null

Minimum estimated employee count (modeled estimate).

​
ESTTURNOVER_MAX
integer<int64> | null

Maximum estimated turnover (modeled estimate).

​
ESTTURNOVER_MIN
integer<int64> | null

Minimum estimated turnover (modeled estimate).

​
EMPLOYEES_MIN
integer<int64> | null

Minimum employees from filed or normalised accounts.

​
EMPLOYEES_MAX
integer<int64> | null

Maximum employees from filed or normalised accounts.

​
TURN_MIN
integer<int64> | null

Minimum turnover (TURN): revenue / sales per filed accounts.

​
TURN_MAX
integer<int64> | null

Maximum turnover (TURN): revenue / sales per filed accounts.

​
PTP_MIN
integer<int64> | null

Minimum profit before tax (pre-tax profit) from filed accounts. Same currency/units as upstream.

​
PTP_MAX
integer<int64> | null

Maximum profit before tax (pre-tax profit) from filed accounts.

​
PAT_MIN
integer<int64> | null

Minimum profit after tax from filed accounts.

​
PAT_MAX
integer<int64> | null

Maximum profit after tax from filed accounts.

​
CASH_MIN
integer<int64> | null

Minimum cash or cash-like balance sheet line (filed accounts).

​
CASH_MAX
integer<int64> | null

Maximum cash or cash-like balance sheet line (filed accounts).

​
TCA_MIN
integer<int64> | null

Minimum total current assets (TCA).

​
TCA_MAX
integer<int64> | null

Maximum total current assets (TCA).

​
TA_MIN
integer<int64> | null

Minimum total assets (TA).

​
TA_MAX
integer<int64> | null

Maximum total assets (TA).

​
TL_MIN
integer<int64> | null

Minimum total liabilities (TL).

​
TL_MAX
integer<int64> | null

Maximum total liabilities (TL).

​
SF_MIN
integer<int64> | null

Minimum shareholders funds / equity (SF).

​
SF_MAX
integer<int64> | null

Maximum shareholders funds / equity (SF).

​
NA_MIN
integer<int64> | null

Minimum net assets (NA).

​
NA_MAX
integer<int64> | null

Maximum net assets (NA).

​
NW_MIN
integer<int64> | null

Minimum net worth (NW), as defined in upstream normalised accounts.

​
NW_MAX
integer<int64> | null

Maximum net worth (NW), as defined in upstream normalised accounts.

​
EXPORT_MIN
integer<int64> | null

Minimum export value (trade statistics field; units per upstream).

​
EXPORT_MAX
integer<int64> | null

Maximum export value (trade statistics field; units per upstream).

​
EBITDA_MIN
number | null

Minimum EBITDA where available in upstream financials.

​
EBITDA_MAX
number | null

Maximum EBITDA where available in upstream financials.

​
Innovation_MIN
number | null

Minimum innovation score or index (product-specific metric).

​
InnovateUKFunding_MIN
number | null

Minimum total Innovate UK grant funding (or equivalent normalised amount).

​
InnovateUKFunding_MAX
number | null

Maximum total Innovate UK grant funding (or equivalent normalised amount).

​
OnlyManufacturingCompanies
boolean
​
OnlyESGCompanies
boolean
​
IsLikelyDistinctBrand
boolean | null
​
SearchPostcode
string
​
SearchPostcodeRadius
integer | null
​
SelectedPostcodeOutcodes
string[]
​
InstantSearchString
string
​
MinPoints
integer
​
MinClusterSize
integer
​
ClusterCount
integer
​
OutlierPercentage
integer
​
ClusteringMethod
string
​
TrimClustersBelowPercentage
string
​
ChangelogStartDate
string<date-time> | null
​
UseSemanticSearch
boolean | null
​
RTICsToExclude
string[]
​
IS8CodesToExclude
string[]

Industry Standard codes (IS-8 scheme) to exclude from results.

Response

200 - application/json

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.

​
companies
(object | string)[]

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/

​
insights
object

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

​
CompanyChanges
object[] | null

Omitted without companies:changes.

​
JobPostingsBySOC4Code
object[] | null

Omitted without lightcast:read.

​
JobPostingsBySOC4Name
object[] | null

Omitted without lightcast:read.

​
JobPostingsByLotName
object[] | null

Omitted without lightcast:read.

​
AverageAdvertisedSalaryBySOC4Code
object[] | null

Omitted without lightcast:read.

​
AverageAdvertisedSalaryBySOC4Name
object[] | null

Omitted without lightcast:read.

​
AverageAdvertisedSalaryByLotName
object[] | null

Omitted without lightcast:read.

​
JobPostingsBySkill
object[] | null

Omitted without lightcast:read.

​
AveragePostingDurationBySkill
object[] | null

Omitted without lightcast:read.

​
RTICJobPostings
object[] | null

Omitted without lightcast:read.

​
RTICVerticalJobPostings
object[] | null

Omitted without lightcast:read.

​
CICJobPostings
object[] | null

Omitted without lightcast:read.

​
CICVerticalJobPostings
object[] | null

Omitted without lightcast:read.

​
CompanyJobPostingsOverTimeBySOC4
object[] | null

Omitted without lightcast:read.

​
CompanyJobPostingsOverTimeByLOT
object[] | null

Omitted without lightcast:read.

​
JobPostingsByCommonSkill
object[] | null

Omitted without lightcast:read.

​
AveragePostingDurationByCommonSkill
object[] | null

Omitted without lightcast:read.

​
JobPostingsByCertificationsSkill
object[] | null

Omitted without lightcast:read.

​
AveragePostingDurationByCertificationsSkill
object[] | null

Omitted without lightcast:read.

​
JobPostingsBySpecializedSkill
object[] | null

Omitted without lightcast:read.

​
AveragePostingDurationBySpecializedSkill
object[] | null

Omitted without lightcast:read.

​
JobPostingInsights
object[] | null

Omitted without lightcast:read.

​
JobPostingInsightsLOT
object[] | null

Omitted without lightcast:read.

​
TotalDealroomFunding
object[] | null

Omitted without dealroom:read.

​
CompaniesWithDealroomFunding
object[] | null

Omitted without dealroom:read.

​
DealroomAverageFundingSizePerYear
object[] | null

Omitted without dealroom:read.

​
DealroomFundingByYear
object[] | null

Omitted without dealroom:read.

​
DealroomFundingRoundsByYear
object[] | null

Omitted without dealroom:read.

​
RTICDealroomFunding
object[] | null

Omitted without dealroom:read.

​
CICDealroomFunding
object[] | null

Omitted without dealroom:read.

​
RTICVerticalDealroomFunding
object[] | null

Omitted without dealroom:read.

​
CICVerticalDealroomFunding
object[] | null

Omitted without dealroom:read.

Last modified on June 23, 2026