Submit Job

MixRank email validation jobs belong to the API key owner and are accessible across that user’s authorized keys. A non-null completed_at indicates completion. download_url provides gzip-compressed JSON Lines output and requires no API key. Each output record contains an email validation assessment and line_number. Private jobs require deletion of the output after download. Limited to 3,000,000 input lines and 20 unfinished jobs per user.

Required permissions for your API key's user: email.validate.bulk.

post/email/validate/bulk-job

Request

Base URL
https://api.mixrank.com/v2/json/YOUR_API_KEY
Auth
none declared

Query parameters

maxageinteger

Optional cache age in seconds, including for strict/besteffort. Without it, any cached result may qualify. Ignored by fetch.

strategy'cached' | 'fetch' | 'strict' | 'besteffort'

cached returns stored data only; fetch requests a refresh. strict uses sufficiently recent cached data, otherwise refreshes; besteffort also falls back to stale cached data when refresh fails.

Request body multipart/form-data

filestring binary required

UTF-8 text containing newline-delimited email addresses.

Response

Successful response.

Example response

{
  "id": "5c91d8a2-9736-4ae1-941d-241971105934",
  "created_at": "2026-10-06 12:00:00",
  "lines_total": 2,
  "lines_processed": 2,
  "lines_refreshed": 2,
  "strategy": "besteffort",
  "maxage": "2026-09-06 12:00:00",
  "completed_at": "2026-10-06 12:05:00",
  "download_url": "https://data.mixrank.com/export/bulk_job/email/3f2b7c9e1a4d5f60718293a4b5c6d7e8.jsonl.gz"
}

Changes

No recorded changes to this operation across all 1 revision of this API.