# Batch enrichment

Bulk enrichment jobs: create, check status, resume, and download results.

## Create Batch Enrichment

 - [POST /public/v1/enrichment/batch/](https://nwnebwvktf.redocly.app/openapi/batch-enrichment/public_v1_enrichment_batch_create.md): Create a batch enrichment job by uploading a CSV.

How it works
1. Upload a .csv file (one column: handle or email)
2. Choose the enrichment mode (handle: raw/full, email: basic/advanced)
3. Use the returned batch_id to check status and download results

Request
- multipart/form-data
- file: CSV (max 10MB)
- Mode fields depend on whether you’re enriching by handle or email

Credits
- Credits are deducted per successfully enriched record
- The credit rate follows the corresponding single-enrichment mode (raw/full/basic/advanced)
- If no data is returned for a record, 0 credits are deducted for that record

## Download Batch Enrichment Results

 - [GET /public/v1/enrichment/batch/{batch_id}/](https://nwnebwvktf.redocly.app/openapi/batch-enrichment/public_v1_enrichment_batch_retrieve.md): Download the results for a completed batch enrichment job.

When to use
- After the batch reaches a completed state in the status endpoint

Credits
- 0 credits (download only)

## Resume Batch Enrichment

 - [POST /public/v1/enrichment/batch/{batch_id}/resume/](https://nwnebwvktf.redocly.app/openapi/batch-enrichment/public_v1_enrichment_batch_resume_create.md): Resume a paused or interrupted batch enrichment job.

When to use
- If a batch was paused or failed mid-run and needs to continue processing

Credits
- 0 credits to resume (credits apply only to successfully enriched records)

## Get Batch Enrichment Status

 - [GET /public/v1/enrichment/batch/{batch_id}/status/](https://nwnebwvktf.redocly.app/openapi/batch-enrichment/public_v1_enrichment_batch_status_retrieve.md): Check the current processing status of a batch enrichment job.

What you get
- Current state (e.g., queued/running/completed/failed)
- Progress indicators (processed vs remaining), when available

Credits
- 0 credits (status only)