---
title: "Create an asynchronous bulk verification job"
method: POST
path: "/api/v1/verify/bulk"
tags: ["Verification", "Jobs"]
---

# Create an asynchronous bulk verification job

`POST /api/v1/verify/bulk`

## Request

- Base URL: `https://verifly.email`
- URL: `https://verifly.email/api/v1/verify/bulk`
- Auth: HTTP bearer

Submit a large email list (as emails[], raw text, or a multipart CSV file) for asynchronous verification. Returns a job with check_status_url / results_url / download_url. Small jobs may complete inline (status 'completed'); larger jobs return status 'pending'. Poll GET /api/v1/jobs/{id} for progress.

## Request body

- BulkVerificationRequest
  - `emails` string[]
  - `text` string: Raw text/CSV to extract emails from when 'emails' is not provided.
  - `filename` string
  - `webhook_url` string, uri: Optional public HTTPS webhook called when the job completes.

## Response `200`

Bulk job accepted (pending) or completed inline.

- BulkJobResult
  - `success` boolean, required
  - `job_id` string, required
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required
  - `total_emails` integer, required
  - `estimated_seconds` integer
  - `summary` JobSummary
    - `valid` integer
    - `invalid` integer
    - `risky` integer
  - `credits_used` integer
  - `credits_remaining` integer
  - `check_status_url` string, required
  - `results_url` string, required
  - `download_url` string, required

## Other responses

- `400`: Invalid request or invalid input.
- `401`: Missing or invalid API key.
- `402`: Not enough Verifly credits to complete the request.
- `429`: Too many requests. Includes Retry-After (seconds) and the X-RateLimit-* headers.
- `500`: Internal server error. Credits are refunded on failed verification exceptions where possible.

---

[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)