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

# Upload a new batch email file for processing

`POST /v1/batch-upload`

This endpoint allows users to upload and start processing a file containing multiple email addresses 
    for batch processing. 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

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