Bulk Jobs

Run verification against a large list of vendors in a single API call. Bulk jobs are processed asynchronously — you poll for status or receive a webhook when complete.

Create a bulk job

curl https://api.vendorval.com/v1/jobs \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "checks": ["sam_registration"],
    "mode": "cached",
    "entities": [
      { "identifiers": [{ "type": "uei", "value": "ABCD12345678" }] },
      { "identifiers": [{ "type": "uei", "value": "EFGH98765432" }], "legal_name": "Beta Corp" }
    ]
  }'

Response:

{
  "id": "job_01...",
  "status": "queued",
  "total": 2,
  "completed": 0,
  "failed": 0,
  "created_at": "2026-04-19T12:00:00Z"
}

Poll for status

GET /v1/jobs/{job_id}

{
  "id": "job_01...",
  "status": "running",
  "total": 2,
  "completed": 1,
  "failed": 0,
  "results_uri": null
}

When status is complete, results_uri contains a signed URL to download the full results as newline-delimited JSON.

Job statuses

Status	Meaning
queued	Waiting for a worker
running	Processing now
complete	All entities processed
failed	Job-level error (individual entity failures are tracked per-result)

Plan limits

Plan	Monthly bulk jobs
Starter	500
Growth	5,000
Enterprise	Unlimited