Enrich People
Start an async job to enrich people with email and/or phone data.
Looks up each person via their LinkedIn URL and returns a job_id
immediately for polling.
Flow:
- Call this endpoint with
people_ids→ receivejob_id - Poll
GET /api/v1/enrich/people/{job_id}every 3-5 seconds - When
statusis"completed", theresultfield contains per-person email/phone data
Credit costs:
- Email enrichment: credits charged per email successfully found (not per attempt)
- Phone enrichment: credits charged per phone number successfully found
- Failed lookups cost nothing
Limits:
- Max 500 people per request
- People must belong to the authenticated user
- People must have a LinkedIn URL for enrichment to work
Example request:
{
"people_ids": [101, 102, 103],
"enrich_emails": true,
"enrich_phones": false
}
Error codes:
INVALID_REQUEST(400) — Empty people_ids or both enrich flags are falsePERSON_NOT_FOUND(404) — One or more people_ids not found or not owned by user
Body
Request to enrich people with email addresses and/or phone numbers.
Starts an async enrichment job. Each person is looked up via their LinkedIn URL. Credits are charged per successful email or phone found.
Poll the returned job_id via GET /api/v1/enrich/people/{job_id} for results.
List of people IDs to enrich (max 500 per request)
1 - 500 elementsWhether to enrich with work email addresses
Whether to enrich with phone numbers (additional credits per phone found)
Response
Successful Response
Response from starting a people enrichment job.
Returns immediately with a job_id. Poll GET /api/v1/enrich/people/{job_id}
for progress and results.