Check a bulk work-email lookup job
companyenrich.people.email.bulk.statusReturns the current status of a bulk person email enrichment job — once completed, includes the results_url to download the full results
- Price
- freeAt list price
- Success rate
- —No success-rate data yetLast 30 days · 0 calls
- Latency p50
- ——
- Last verified
- Aug 20, 2026Verified working
GEThttps://toolswitch.dev/v1/tools/companyenrich.people.email.bulk.statusBeta- Uses platform quota
- Synchronous response
- Reads public data
Parameters
FREE poll. Breaks the outcome down into found_count / not_found_count / unavailable_count and reports the settled credits_charged, so it is also the receipt. `results_url` is a pre-signed download link present only once the job completes.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Path parameters | ||||
jobId | string | Required | the `job_id` from companyenrich.people.email.bulk.start | 01a01ca3-7120-7ee5-beba-a7bc64de4ea7 |
- Path parameters
jobIdstringRequiredthe `job_id` from companyenrich.people.email.bulk.start
Example:
01a01ca3-7120-7ee5-beba-a7bc64de4ea7
Example response
JSON
{
"job_id": "01a01ca3-7120-7ee5-beba-a7bc64de4ea7",
"status": "completed",
"created_at": "2026-08-20T00:47:48.511339Z",
"started_at": "2026-08-20T00:47:50.093634Z",
"chunk_count": 1,
"found_count": 1,
"results_url": "https://api.companyenrich.com/people/email/bulk/01a01ca3-7120-7ee5-beba-a7bc64de4ea7/results?sig=<signed-token-elided>",
"completed_at": "2026-08-20T00:47:50.695309Z",
"total_requests": 1,
"credits_charged": 0,
"not_found_count": 0,
"processed_chunks": 1,
"unavailable_count": 0
}Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
Beta
curl -X GET 'https://toolswitch.dev/v1/tools/companyenrich.people.email.bulk.status' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/companyenrich.people.email.bulk.status",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/companyenrich.people.email.bulk.status", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());This gateway API is in beta; its URL and authentication may change. The example parameters are sample data. Calls are billed at free, including the service fee.