POST/v2/live/person/validate/bulk

Bulk validate enrichment requests

Validates whether multiple person enrichment requests have sufficient information and valid URLs. Accepts up to 250 requests.

Version: v2Open on v3
Rate limit: Tier 4 · 10–500 rps by plan
Billing: Person Enrichment · Bulk validate enrichment requests

Core Concepts: Credits, Tiers & Environments Workflows: Enrich a CRM List

Request body

metadataobjectOptional
Optional metadata to associate with the request. Will be returned in the response.
pdlIdstringOptional
The person's PDL ID.
personIdinteger (int64)Optional
The AggKnowledge person ID.
professionalSocialMediaUrlstringOptional
LinkedIn URL of the person. Protocol and subdomain are optional, this value will be normalized server-side. Sales Nav and Recruiter URLs are allowed.
freshnessenum PersonEnrichmentFreshnessOptional
Controls whether to use cached data regardless of age. FRESH (default) re-scrapes stale profiles; CACHED returns stored data without a freshness check.
linkedinUrlstringOptional
Legacy name for professionalSocialMediaUrl. Send one profile identifier per request
linkedinUsernamestringOptional
Profile username, an alternative to professionalSocialMediaUrl. Send one profile identifier per request: which one wins when several are sent differs by endpoint

Headers: x-api-key Required · API key for authentication

Response

hasSufficientIdentifiersboolean
Whether the request has sufficient identifiers to proceed with enrichment
isLinkedinUrlValidboolean
Whether any provided LinkedIn URL is valid
isValidboolean
Whether the request is valid for enrichment
metadataobject
Caller-supplied metadata echoed back from the request.
validationMessagestring
Description of any validation issues found

Status codes

Response

Example

[
  {
    "hasSufficientIdentifiers": true,
    "isLinkedinUrlValid": true,
    "isValid": true,
    "metadata": {},
    "validationMessage": "Request is valid for enrichment"
  }
]