/api/v1/companies/enrich-bulk

10 credits

Submit a bulk company-enrichment job (up to 1000 organizations). POST a JSON body; returns a job_id to poll via /api/v1/companies/enrich-bulk-status. Billed at 10 credits per item submitted.

Try in Playground

Parameters

Name	Type	Required	Description
items	string	yes	JSON body field: an array (1-1000) of company ids (org_...) and/or public slugs to enrich. (e.g. `["org_jb3e59e3q21b8", "microsoft"]`)

Example request

curl -H "X-API-Key: zq_…" \
  "https://zooq.dev/api/v1/companies/enrich-bulk?items=%5B%22org_jb3e59e3q21b8%22%2C+%22microsoft%22%5D"

Example response

// POST body: { "items": ["org_jb3e59e3q21b8", "microsoft"] }
{
  "success": true,
  "statusCode": 202,
  "message": "Job accepted",
  "errors": null,
  "data": { "job_id": "job_7dh1m4" }
}

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 →