Poll the status of a people enrichment job.
Returns the current status and, when completed, per-person results with emails and phone numbers found, plus credits consumed.
Status values:
pending — Job created, not yet startedrunning — Enrichment in progresscompleted — All done; check result for per-person data and credits_used for costfailed — Job failed; check error_messagePolling recommendation: Every 3-5 seconds. Typical enrichment takes ~2 seconds per person due to upstream API rate limiting (30 requests/minute).
Example response (completed):
{
"job_id": "abc-123",
"status": "completed",
"progress": {"total": 3, "completed": 3, "emails_found": 2, "phones_found": 0},
"credits_used": {"emails": 2, "phones": 0, "total": 2},
"result": [
{"person_id": 101, "email": "alice@company.com", "status": "enriched"},
{"person_id": 102, "email": "bob@company.com", "status": "enriched"},
{"person_id": 103, "email": null, "status": "not_found"}
]
}
Successful Response
Response from polling a people enrichment job.
Status values:
pending — Job created, not yet startedrunning — Enrichment in progresscompleted — All done; result contains per-person datafailed — Job failed; check error_messagePolling recommendation: Every 3-5 seconds. Typical enrichment takes ~2 seconds per person due to upstream API rate limiting.
Job ID
'pending', 'running', 'completed', or 'failed'
Progress info — available when status is 'running' or 'completed'
Credits consumed — available when status is 'completed'
Per-person enrichment results — available when status is 'completed'
Error details — present only when status is 'failed'