LeadMagic — Bulk jobs & uploaders

Async enrichment for lists. Bills per successful row at the same rate as the matching single-request product; failed rows are free. Any list ≥ 50 rows belongs here — never a loop of single calls.

Workflow

1. Preflight: GET /v1/credits + POST /v1/batch/preview-cost (both free).
2. Validate mapping (free): POST /bulk/validate.
3. Submit: POST /bulk/submit.
4. Poll GET /bulk/jobs/{jobId} ≥45s apart, or set a callback webhook, or stream GET /bulk/jobs/{jobId}/stream.
5. Fetch: GET /bulk/jobs/{jobId}/download (file) or /results / /rows (paged). Failed rows: /errors (free) — fix and resubmit only the misses.

Submit shapes