Skip to main content
GET
/
v2
/
explore
/
{listId}
Get explore list details
curl --request GET \
  --url https://product-api.thedatacity.com/api/v2/explore/{listId} \
  --header 'Authorization: Bearer <token>'
{
  "ListName": "<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.

Path Parameters

listId
integer
required

ML or Explore list ID from the platform.

Query Parameters

returnCount
integer
default:40

Page size for list responses (default 40, max 1000).

Required range: 1 <= x <= 1000
skip
integer

Number of records to skip (pagination).

Required range: x >= 0
CompanyStatus
string
default:Active

Company status filter passed through to classification (default Active).

insights
string
default:false

String flag forwarded to filtered-companies (default false).

Response

200 - application/json

List name plus filtered companies from the product API.

This gateway prefixes ListName then merges the product API classify or filtered-companies payload.

ListName
string

Display name of the smart list or explore list in the platform.

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