---
title: "/v1/bulk"
method: POST
path: "/v1/bulk"
---

# /v1/bulk

`POST /v1/bulk`

## Request

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

Initiate a bulk email verification.

## Request body

- object
  - `input` string[], required: A list of emails to verify.
  - `webhook` TaskWebhook: Optional webhook configuration for sending email verification results during bulk verification.
    - `on_each_email` Webhook: Configuration for a webhook to receive email verification results. The method will be POST, and the body will contain the email verification response.
      - `url` string, required: The URL to send the email verification results to.
      - `extra` object

## Response `200`

OK

- object
  - `job_id` integer, required: The unique ID generated for this bulk verification job. Use this `job_id` to query the progress or results of the bulk verification.

## 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/post.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)