LEleadmagic
Bulk Jobs

Validate a Bulk Submission

Changed on

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

post/bulk/validate

Request

  • Base URL
    https://api.leadmagic.io
  • Auth
    API key in header X-API-Key

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

Changes

  • 1f289eff3a26Revision changes
    • breaking

      the ////// response's property format changed from uri to uri-reference for status

    • breaking

      the ////////// response's property format changed from uri to uri-reference for status

    • breaking

      the ////////// response's property format changed from uri to uri-reference for status

  • f01f73557a67Revision changes
    • info

      endpoint added