---
title: "People Intelligence (Bulk)"
method: POST
path: "/bulk-intelligence/people"
tags: ["Enrichment"]
---

# People Intelligence (Bulk)

`POST /bulk-intelligence/people`

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.

## Query parameters

- `cost_units` 'cents' | 'credits' — Response cost unit.

## Headers

- `Idempotency-Key` string, nullable — Optional idempotency key for retry-safe bulk submissions.
- `x-api-key` string, nullable

## Response `200`

Successful Response

- BulkIntelligenceStartedResponse — 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 — Job status, typically 'RUNNING'.
  - `row_count` integer, nullable — Number of parsed input rows; omitted on idempotent replays.
  - `estimated_cost_cents` integer, 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_credits` number, nullable — Estimated job cost in credits. Returned when cost_units=credits.
  - `already_started` boolean, nullable — True when the request was deduplicated via Idempotency-Key header.

## Other responses

- `400` — Request was rejected by the route's validation rules.
- `401` — Machine authentication required.
- `402` — Insufficient credits or no active subscription for this organization.
- `403` — Tier or feature not enabled for this organization.
- `422` — Request body failed validation.
- `429` — Rate limit exceeded.
- `500` — Unexpected server error. Retry with backoff.

---

[API](https://skmtc.net/sixtyfour/apis/sixtyfour-api.md) · [All operations](https://skmtc.net/sixtyfour/apis/sixtyfour-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sixtyfour/sixtyfour-api/versions/51f0a2b62b44/schema)