---
title: "Get bulk email enrichment job status"
method: GET
path: "/people/email/bulk/{jobId}"
tags: ["People / Enrichment"]
---

# Get bulk email enrichment job status

`GET /people/email/bulk/{jobId}`

## Request

- Base URL: `https://api.companyenrich.com`
- URL: `https://api.companyenrich.com/people/email/bulk/{jobId}`
- Auth: API key in header `Authorization`

**Cost:** FREE - No credits deducted

Returns the current status of a bulk person email enrichment job.
Once completed, includes the results_url to download the full results.

## Path parameters

- `jobId` string, uuid, required

## Response `200`

OK

- BulkPersonEmailEnrichmentStatusResponse
  - `job_id` string, uuid: Unique identifier for the bulk person email enrichment job.
  - `status` 'pending' | 'processing' | 'completing' | 'completed' | 'failed': Current status of the job (pending, processing, completing, completed, failed).
  - `total_requests` integer: Number of lookup items queued in the job.
  - `found_count` integer: Number of lookup items that found an email.
  - `not_found_count` integer: Number of lookup items that were definitively not found.
  - `unavailable_count` integer: Number of lookup items that ended in unavailable status.
  - `chunk_count` integer: Total number of chunks in the job.
  - `processed_chunks` integer: Number of chunks that have been completed.
  - `credits_charged` integer: Total credits charged for this job.
  - `created_at` string, date-time: Timestamp when the job was created.
  - `started_at` string, date-time, nullable: Timestamp when the job started processing.
  - `completed_at` string, date-time, nullable: Timestamp when the job completed.
  - `results_url` string, nullable: URL to download the enrichment results (available when completed).
  - `error_message` string, nullable: Error message if the job failed.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)