Skip to main content
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

X-API-Key
string
header
required

API key for authentication

Path Parameters

job_id
string
required

Response

Successful Response

Status snapshot of a bulk lookup job.

job_id
string<uuid>
required

Unique job identifier.

Example:

"123e4567-e89b-12d3-a456-426614174000"

status
enum<string>
required

Job status: running (still processing) or completed (all rows done).

Available options:
running,
completed
Example:

"running"

total_rows
integer
required

Total rows submitted.

Example:

500

total_processed
integer
required

Rows processed so far.

Example:

237

summary
BulkLookupSummary · object
required

Per-outcome counts.

created_at
string
required

Job submission timestamp (UTC).

Example:

"2026-04-21T14:30:00Z"

finished_at
string | null

Timestamp of the last processed row (UTC). Null while running.

Example:

null