---
title: "File upload"
method: POST
path: "/bulkapi/v2/upload"
tags: ["Bulk API"]
---

# File upload

`POST /bulkapi/v2/upload`

## Request

- Base URL: `//bulkapi.millionverifier.com` (relative, and the document’s source URL is not known)
- URL: `//bulkapi.millionverifier.com/bulkapi/v2/upload`
- Auth: none declared

Upload file containing email addresses for verification

## Query parameters

- `key` string, required

## Request body `multipart/form-data`

- object
  - `file_contents` string, binary

## Response `200`

Succesful request

- union
  - BulkapiUploadSuccess
    - `file_id` string: The ID of the uploaded file
    - `file_name` string: The name of the uploaded file
    - `status` string: The status of the verification
    - `unique_emails` integer: The number of unique emails found in the file
    - `updated_at` string: The last update of the file
    - `createdate` string: The date of creation
    - `percent` integer: Progress percentage
    - `total_rows` integer: Total rows in the file
    - `verified` integer: Amount of verified
    - `unverified` integer: Amount of unverified
    - `ok` integer: Amount of ok emails
    - `catch_all` integer: Amount of catch all emails
    - `disposable` integer: Amount of disposable emails
    - `invalid` integer: Amount of invalid emails
    - `unknown` integer: Amount of unknown emails
    - `reverify` integer: Amount of emails that needs to be reverified
    - `credit` integer: Amount of credits needed for the verification of the file
    - `estimated_time_sec` integer: Amount of estimated seconds it will take to verify the file
    - `error` string: Any errors that happened with the file
  - BulkapiInsufficientCredits
    - `error` string: Error message
    - `unique_emails` integer: Number of unique emails in file
    - `credits` integer: Available credits

---

[API](https://skmtc.dev/millionverifier/apis/millionverifier-api.md) - [All operations](https://skmtc.dev/millionverifier/apis/millionverifier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/millionverifier/apis/millionverifier-api/revisions/f4cad21f5f62?raw)