MImixrank
Email

Check 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.

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

get/email/validate/bulk-job/{job_id}

Request

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

Path parameters

job_idstring uuid required
Example:5c91d8a2-9736-4ae1-941d-241971105934

Job ID from the submission response, owned by the requesting user. Accepts UUID text with or without hyphens.

Response

Successful response.

idstring uuid

Job ID, scoped to the requesting user across their API keys.

created_atstring nullable

Job creation UTC time.

lines_totalinteger nullable

Total items extracted from input file.

lines_invalidinteger nullable

Number of items which were not deemed as valid email addresses.

lines_processedinteger nullable

Total items processed so far.

lines_refreshedinteger nullable

Total items that were refreshed.

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

Strategy used for all items.

maxagestring nullable

UTC cache timestamp cutoff; null when no cutoff applies. The request maxage is a duration in seconds.

completed_atstring nullable

UTC completion time; null while pending.

download_urlstring uri nullable

Output download URL; null until output exists or after deletion.

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.