---
title: "Verify batch of emails (max 3000 emails)"
method: POST
path: "/verify/email/batch"
tags: ["verifications"]
---

# Verify batch of emails (max 3000 emails)

`POST /verify/email/batch`

## Request

- Base URL: `https://api.listclean.xyz/v1`
- URL: `https://api.listclean.xyz/v1/verify/email/batch`
- Auth: API key in header `X-Auth-Token`

## Request body

- object
  - `filename` string: Optional source filename. If omitted, the API generates a UTC filename in the format batch_upload-DD-MM-YYYY-HHMMSS-utc.csv (for example, batch_upload-05-10-2026-143025-utc.csv). A .csv extension is added when a supplied filename has no extension.
  - `emails` string[], required: Email addresses to verify. The default limit is 3,000 addresses per request.

## Response `200`

Response on success

- object
  - `success` 0 | 1: Success status, 0 for failed 1 for success
  - `message` string
  - `error_code` integer
  - `data` object
    - `list_id` integer: List ID (request ID) for tracking the batch job.

## Other responses

- `400`: Parameter emails is required
- `401`: Auth Failed

---

[API](https://skmtc.dev/listclean/apis/listclean-api-beta.md) · [All operations](https://skmtc.dev/listclean/apis/listclean-api-beta/llms.txt) · [OpenAPI document](https://skmtc.dev/listclean/apis/listclean-api-beta/revisions/780c4fe6db87?raw)