Email finder (unlimited)
Bulk Lookup Job Status (Unlimited Plans)
Check the status and progress of an unlimited-plan bulk lookup job.
GET
Unlimited Bulk Lookup Status
Status endpoint for jobs submitted via POST /v1/unlimited/bulk-lookup. The response contract (status values,
summary counts, row totals) is identical to GET /v1/bulk-lookup/{job_id}; see that page for field meanings and polling guidance.
Requires the Unlimited API key that created the job. Polling this endpoint consumes no quota (neither the monthly cap nor the daily search limit); it counts only against the shared per-key request-rate window, so poll every 10 to 30 seconds rather than in a tight loop.Authorizations
API key for authentication
Path Parameters
Response
Successful Response
Status snapshot of a bulk lookup job.
Unique job identifier.
Example:
"123e4567-e89b-12d3-a456-426614174000"
Job status: running (still processing) or completed (all rows done).
Available options:
running, completed Example:
"running"
Total rows submitted.
Example:
500
Rows processed so far.
Example:
237
Per-outcome counts.
Job submission timestamp (UTC).
Example:
"2026-04-21T14:30:00Z"
Timestamp of the last processed row (UTC). Null while running.
Example:
null