POST/v3/live/person/synchronous/validate

Bulk validate enrichment requests

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

Version: v3Open on v2
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

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.
metadataobjectOptional
Optional metadata to associate with the request. Will be returned in the response.
personIdstringOptional
The AggKnowledge person ID.
socialProfilestringOptional
Social profile URL of the person. Protocol and subdomain are optional; we normalize the URL server-side. Sales Navigator lead URLs and Recruiter /talent/profile/ URLs are also accepted.

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

Response

hasSufficientIdentifiersboolean
Whether the request has sufficient identifiers to proceed with enrichment
isSocialProfileValidboolean
Whether any provided social profile 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,
    "isSocialProfileValid": true,
    "isValid": true,
    "metadata": {},
    "validationMessage": "Request is valid for enrichment"
  }
]