---
title: "Check Job"
method: GET
path: "/email/validate/bulk-job/{job_id}"
tags: ["Email"]
---

# Check Job

`GET /email/validate/bulk-job/{job_id}`

## Request

- Base URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY`
- URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY/email/validate/bulk-job/{job_id}`
- Auth: none declared

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

## Path parameters

- `job_id` string, uuid, required

## Response `200`

Successful response.

- object
  - `id` string, uuid: Job ID, scoped to the requesting user across their API keys.
  - `created_at` string, nullable: Job creation UTC time.
  - `lines_total` integer, nullable: Total items extracted from input file.
  - `lines_invalid` integer, nullable: Number of items which were not deemed as valid email addresses.
  - `lines_processed` integer, nullable: Total items processed so far.
  - `lines_refreshed` integer, nullable: Total items that were refreshed.
  - `strategy` 'cached' | 'fetch' | 'strict' | 'besteffort', nullable: Strategy used for all items.
  - `maxage` string, nullable: UTC cache timestamp cutoff; null when no cutoff applies. The request maxage is a duration in seconds.
  - `completed_at` string, nullable: UTC completion time; null while pending.
  - `download_url` string, uri, nullable: Output download URL; null until output exists or after deletion.

## Other responses

- `400`: Malformed job UUID.
- `403`: Invalid key or insufficient endpoint permissions.
- `404`: Job does not exist or belongs to another user.
- `408`: Database operation timed out; retry later.
- `429`: Concurrent request limit exceeded.
- `500`: Internal API error.

---

[API](https://skmtc.dev/mixrank/apis/mixrank-api.md) - [All operations](https://skmtc.dev/mixrank/apis/mixrank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixrank/apis/mixrank-api/revisions/786d3fcfe918?raw)