Skip to main content
POST
Company Intelligence (Bulk)

Authorizations

x-api-key
string
header
required

Your Sixtyfour API key.

Headers

Idempotency-Key
string | null

Optional idempotency key for retry-safe bulk submissions.

Maximum string length: 255

Body

multipart/form-data
file
file
required

CSV, JSON, JSONL, or NDJSON file (max 100 MB / 100,000 rows).

config
string
required

The settings as a JSON string (fields below), up to 1,000,000 characters.

Maximum string length: 1000000

Response

Successful Response

Response when a bulk intelligence job is started.

task_id
string
required

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

status
string
required

RUNNING. An Idempotency-Key replay returns the run's current status in capitals, such as COMPLETED.

row_count
integer | null

Number of parsed input rows; omitted on idempotent replays.

estimated_cost_cents
integer | null
deprecated

Deprecated. Use estimated_cost_credits. The same amount in tenths of a credit.

estimated_cost_credits
number | null

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

already_started
boolean | null

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