/api/v1/email/find-bulk

10 credits

Submit a bulk work-email-finding job (up to 1000 queries). POST a JSON body; returns a job_id to poll via /api/v1/email/find-bulk-status. Billed at 10 credits per query submitted.

Try in Playground

Parameters

Name	Type	Required	Description
queries	string	yes	JSON body field: an array (1-1000) of { first_name, last_name, domain } objects (each field required). Billing is per query SUBMITTED (10 credits each), counted before the upstream drops incomplete/duplicate queries — so clean your list first to avoid paying for repeats. (e.g. `[{ "first_name": "Satya", "last_name": "Nadella", "domain": "microsoft.com" }]`)

Example request

curl -H "X-API-Key: zq_…" \
  "https://zooq.dev/api/v1/email/find-bulk?queries=%5B%7B+%22first_name%22%3A+%22Satya%22%2C+%22last_name%22%3A+%22Nadella%22%2C+%22domain%22%3A+%22microsoft.com%22+%7D%5D"

Example response

// POST body: { "queries": [{ "first_name": "Satya", "last_name": "Nadella", "domain": "microsoft.com" }] }
{
  "success": true,
  "statusCode": 202,
  "message": "Job accepted",
  "errors": null,
  "data": { "job_id": "job_f4n7q1" }
}

Successful responses are wrapped in the standard envelope. The data field carries the actual payload; errors is null on success.

Want to try this endpoint?

300 free credits on signup, no card required. That covers 30 calls.

Get an API key →