---
title: "/v1/bulk/{job_id}"
method: GET
path: "/v1/bulk/{job_id}"
---

# /v1/bulk/{job_id}

`GET /v1/bulk/{job_id}`

## Request

- Base URL: `https://api.reacher.email`
- URL: `https://api.reacher.email/v1/bulk/{job_id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/reacherhq/apis/reacher/docs/v1/bulk/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the progress of a bulk verification job.

## Response `200`

OK

- object
  - `job_id` integer, required
  - `created_at` string, date-time, required: The date and time when the bulk verification job was created.
  - `finished_at` string, date-time: If the bulk verification job is completed, the date and time when it was finished.
  - `total_records` integer, required: The number of emails to verify in the bulk verification job.
  - `total_processed` integer, required: The number of emails that have been verified at the time of the query.
  - `summary` object, required: A summary of the processed emails.
    - `total_safe` integer, required: The number of emails where `is_reachable` is "safe".
    - `total_invalid` integer, required: The number of emails where `is_reachable` is "invalid".
    - `total_risky` integer, required: The number of emails where `is_reachable` is "risky".
    - `total_unknown` integer, required: The number of emails where `is_reachable` is "unknown".
  - `job_status` 'Running' | 'Completed', required: The status of the job, either "Running" or "Completed".

## Changes

- **2024-11-25** `e205c9ae16c8`: 1 info
  - endpoint added
- **2022-08-15** `f6c5a050fb0f`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/reacherhq/apis/reacher/changes/v1/bulk/:job_id/get.md)

---

[API](https://skmtc.dev/reacherhq/apis/reacher.md) - [All operations](https://skmtc.dev/reacherhq/apis/reacher/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherhq/apis/reacher/revisions/e829a8a612e2?raw)