---
title: "Submit a new batch email file for processing"
method: POST
path: "/v1/batch-process-email"
tags: ["Email Verification"]
---

# Submit a new batch email file for processing

`POST /v1/batch-process-email`

This endpoint allows users to upload a file containing multiple email addresses for batch processing. 
    The complete filename should be less than 120 chracters.
    When a file is submitted, it is added to a queue for asynchronous processing and assigned a process_id. 
    The file is marked as "QUEUED," and a message indicates that processing will begin soon. 
    Each user has their own dedicated queue for tasks. The response includes the process_id and filename, 
    along with the initial status of "PROCESSING QUEUED." Users can later check the status using the process_id.

## Query parameters

- `metadata` boolean — Include detailed metadata in response

## Request body

- BatchEmailRequest
  - `filename` string, required

## Response `200`

Successful Response

- BatchEmailResponse
  - `process_id` integer, required
  - `filename` string, required
  - `status` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/revenuebase/apis/revenuebase-email-verification.md) · [All operations](https://skmtc.net/revenuebase/apis/revenuebase-email-verification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/revenuebase/revenuebase-email-verification/versions/754d665f9402/schema)