POST/v2/live/discover/people/validate

Validate a discover people request

Validates all field values in a discover people request and returns detailed warnings for any invalid values (especially enums such as role, industry, seniority). It also flags a request too large to evaluate (QUERY_TOO_LARGE), which a search would refuse with a 400. Does not perform a search or consume credits.

Version
v2 · Deprecated
Rate limit
Tier 2 · 10–100 rps by plan
Billing
Discover · Validate a discover people request

Request body

  • aggkCompanyIdstring[]Optional
    AggKnowledge Company IDs to restrict search to specific companies
  • aggkProductIdinteger (int64)[]Optional
    AggKnowledge Product IDs
    48211
    Enter adds a value · Backspace on empty removes the last
  • categoryIdinteger (int64)[]Optional
    Category IDs
  • companyTypestring[]Optional
    Company type
  • countrystringOptional
    Company country
  • cursorstringOptional
    Pagination cursor from previous response for fetching next page of results
  • earliestCurrentStartDateAtCompanystringOptional
    Earliest current stint start date at the company (YYYY, YYYY-MM, or YYYY-MM-DD)
  • earliestEndDatestringOptional
    Earliest end date for work experiences (YYYY, YYYY-MM, or YYYY-MM-DD)
  • earliestOriginalStartDateAtCompanystringOptional
    Earliest original start date at the company (YYYY, YYYY-MM, or YYYY-MM-DD)
  • earliestStartDatestringOptional
    Earliest start date for work experiences (YYYY, YYYY-MM, or YYYY-MM-DD)
  • employeeCountRangestring[]Optional
    Employee count ranges
  • fundingRoundCountobjectOptional
    Funding round count range
  • fundingTotalobjectOptional
    Total funding range
  • industrystring[]Optional
    Industry categories
  • jobTitlestring[]Optional
    Job titles. Bounded by the total number of words rather than by the number of values, so one long title costs as much as several short ones; a filter too large to evaluate is rejected with a 400
  • latestCurrentStartDateAtCompanystringOptional
    Latest current stint start date at the company (YYYY, YYYY-MM, or YYYY-MM-DD)
  • latestEndDatestringOptional
    Latest end date for work experiences (YYYY, YYYY-MM, or YYYY-MM-DD)
  • latestFundingAmountobjectOptional
    Latest funding amount range
  • latestFundingDateobjectOptional
    Latest funding date range
  • latestFundingStagestring[]Optional
    Latest funding stage
  • latestOriginalStartDateAtCompanystringOptional
    Latest original start date at the company (YYYY, YYYY-MM, or YYYY-MM-DD)
  • latestStartDatestringOptional
    Latest start date for work experiences (YYYY, YYYY-MM, or YYYY-MM-DD)
  • limitinteger (int32)Optional
    Maximum number of results to return per page (default: 1000, max: 1000)
  • localitystringOptional
    Company locality
  • metadataobjectOptional
    Optional metadata to associate with the request. Will be returned in the response.
  • personCountrystringOptional
    Person country
  • personFilterenum PersonFilterOptional
    Person employment filter
  • personLocalitystringOptional
    Person locality (city)
  • personRegionstringOptional
    Person region (state)
  • primaryExchangestring[]Optional
    Primary exchanges
  • primaryTickerstring[]Optional
    Primary ticker symbols
  • regionstringOptional
    Company region
  • revenueRangeInferredstring[]Optional
    Revenue range inferred
  • rolestring[]Optional
    Roles
  • senioritystring[]Optional
    Seniority levels
  • subrolestring[]Optional
    Sub-roles
  • groupingobjectOptional
    Result diversity controls
Headers
x-api-key Required · API key for authentication

Response

  • isValidboolean
    Whether all provided values are valid (true when warnings is empty)
  • metadataobject
    Caller-supplied metadata echoed back from the request.
  • warningsobject[]
    List of validation warnings, one per invalid field value

Status codes