---
title: "Get bulk job status"
method: GET
path: "/api/v1/jobs/{id}"
tags: ["Jobs"]
---

# Get bulk job status

`GET /api/v1/jobs/{id}`

## Request

- Base URL: `https://verifly.email`
- URL: `https://verifly.email/api/v1/jobs/{id}`
- Auth: HTTP bearer

Get status and progress for a single bulk verification job.

## Path parameters

- `id` string, required

## Response `200`

Job status.

- Job
  - `success` boolean, required
  - `job_id` string, required
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required
  - `progress` integer
  - `total_emails` integer
  - `processed` integer
  - `summary` JobSummary
    - `valid` integer
    - `invalid` integer
    - `risky` integer
  - `credits_used` integer
  - `file_name` string
  - `error_message` string, nullable
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable
  - `results_url` string, nullable
  - `download_url` string, nullable

## Other responses

- `401`: Missing or invalid API key.
- `404`: Resource not found or not owned by the authenticated account.

---

[API](https://skmtc.dev/verifly/apis/verifly-email-verification-api.md) · [All operations](https://skmtc.dev/verifly/apis/verifly-email-verification-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verifly/apis/verifly-email-verification-api/revisions/9b2787c04363?raw)