Skip to main content
GET
Get explore list details

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 | null

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.

Last modified on August 14, 2026