Download the final enriched dataset after processing is complete.

Tip: For CSV downloads, consider using the recommended endpoint GET /public/v1/enrichment/batch/{batch_id}/download/ instead — it returns a presigned URL for faster, more reliable downloads. Use this endpoint if you need JSON output or as a fallback.

Requirements

• Batch must be in finished status
• Results file must have been generated

Output formats

• CSV (default) — omit format or pass ?format=csv
• JSON — pass ?format=json to receive a JSON array where each object has:   - input_value — the original input (handle or email)   - status — enrichment status for that record   - enrichment_data — the enriched creator data

Error Responses

Every error response shares the canonical shape {"error": <message>, "error_code": <slug>, ...}. Branch programmatically on error_code rather than parsing error.

• 400 Bad Request (error_code: "batch_not_ready") — batch not completed yet; current_status is included in the body
• 400 Bad Request (error_code: "no_results") — batch finished but produced no rows
• 400 Bad Request (error_code: "results_not_ready") — batch finished but the results file is still being assembled
• 404 Not Found (error_code: "batch_not_found") — invalid batch ID or batch does not belong to client
• 500 Server Error (error_code: "service_error") — results file could not be retrieved from storage; safe to retry

Credits

• 0 credits (download only)

<div class="ic-ai-prompt-root" data-endpoint="batch-download"></div>