People / Enrichment

Get bulk email enrichment job status

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.

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

Path parameters

jobIdstring uuid required

Response

OK

job_idstring 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_requestsinteger

Number of lookup items queued in the job.

found_countinteger

Number of lookup items that found an email.

not_found_countinteger

Number of lookup items that were definitively not found.

unavailable_countinteger

Number of lookup items that ended in unavailable status.

chunk_countinteger

Total number of chunks in the job.

processed_chunksinteger

Number of chunks that have been completed.

credits_chargedinteger

Total credits charged for this job.

created_atstring date-time

Timestamp when the job was created.

started_atstring date-time nullable

Timestamp when the job started processing.

completed_atstring date-time nullable

Timestamp when the job completed.

results_urlstring nullable

URL to download the enrichment results (available when completed).

error_messagestring nullable

Error message if the job failed.

Changes