v3

latestOpenAPI 3.1.02026-07-318648277.6 KB

Bulk Jobs

Validate a Bulk Submission

Validate a bulk submission payload without persisting or processing a job.

post/bulk/validate

Request body

productstring required

The enrichment product to run on each row (e.g. email_finder, email_validation, mobile_finder, profile_search, company_search).

rowsobject[]

JSON array of row objects for /bulk/json (or /bulk/submit auto-detect). Each row is an object whose keys match the input fields the selected product expects.

csvstring

Inline CSV string for /bulk/csv (or /bulk/submit).

fileUrlstring uri

Public HTTPS URL to a remote file (CSV, JSON, JSONL). SSRF-validated server-side.

format'csv' | 'json' | 'jsonl'

File format for fileUrl submissions.

inputMappingobject

Optional column mapping from CSV/JSON columns to product input fields.

idempotencyKeystring

Optional idempotency key for safe retries.

metadataobject

presetIdstring

priorityinteger

fileNamestring

Example request

{
  "product": "email_finder",
  "outputTransform": {
    "model": "llama-3.1-8b-instruct"
  }
}

Response

Validation result.

object required