---
title: "Upload a list of emails for batch verification"
method: POST
path: "/api/v1/bulk/upload"
tags: ["Batch"]
---

# Upload a list of emails for batch verification

`POST /api/v1/bulk/upload`

Accepts up to 10,000 emails per job. Duplicates are removed automatically and only unique addresses consume credits. Verification starts immediately; poll the status endpoint for progress.

## Request body

- object
  - `emails` string[], required

## Response `200`

Job created and queued

- object
  - `success` boolean
  - `jobId` string, uuid
  - `totalEmails` integer
  - `duplicateCount` integer
  - `skippedRows` integer
  - `emptyRows` integer
  - `invalidRows` integer
  - `estimatedTimeSeconds` integer

## Other responses

- `401` — Missing or invalid API key
- `402` — Not enough credits (code INSUFFICIENT_CREDITS)

---

[API](https://skmtc.dev/clearbounce/apis/clearbounce-api.md) · [All operations](https://skmtc.dev/clearbounce/apis/clearbounce-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clearbounce/clearbounce-api/revisions/24d5e66f3f11/schema)