---
title: "List Jobs"
method: GET
path: "/email/validate/bulk-job"
tags: ["Email"]
---

# List Jobs

`GET /email/validate/bulk-job`

## 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`
- Auth: none declared

MixRank email validation jobs belong to the API key owner and are accessible across that user’s authorized keys. Lists job metadata newest first. 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`.

## Query parameters

- `page_size` integer
- `offset` integer

## Response `200`

Successful response.

- union
  - object
    - `total` integer: Number of jobs returned on this page.
    - `offset` integer
    - `page_size` integer
    - `results` 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.
  - object
    - `errors` object, required

## Other responses

- `403`: Invalid key or insufficient endpoint permissions.
- `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)