v1

latestOpenAPI 3.1.0Proprietary2026-07-265759203.4 KB

Enrichment

People Intelligence (Bulk)

Upload a CSV/JSON/NDJSON file and start a background bulk intelligence run.

Poll GET /job-status/{task_id}; on completion the response includes signed download links and charge_amount (total cents charged). Row-level failures pass through un-enriched; source-block failures fail the run.

post/bulk-intelligence/people

Query parameters

cost_units'cents' | 'credits'

Response cost unit.

Headers

Idempotency-Keystring nullable

Optional idempotency key for retry-safe bulk submissions.

x-api-keystring nullable

Response

Successful Response

task_idstring required

Job ID. Poll GET /job-status/{task_id}; on completion the response includes signed download links for result files.

statusstring required

Job status, typically 'RUNNING'.

row_countinteger nullable

Number of parsed input rows; omitted on idempotent replays.

estimated_cost_centsinteger nullable

Estimated job cost in cents (rows × per-row tier price). A floor: options like find_people can bill more. Omitted on idempotent replays. Returned when cost_units=cents.

estimated_cost_creditsnumber nullable

Estimated job cost in credits. Returned when cost_units=credits.

already_startedboolean nullable

True when the request was deduplicated via Idempotency-Key header.