---
canonical_url: "https://docs.composio.dev/toolkits/mailveri"
markdown_url: "https://docs.composio.dev/toolkits/mailveri.md"
product: "platform"
version: null
last_updated: null
---

# MailVeri

MailVeri verifies individual email addresses and processes bulk email verification jobs through its REST API.

- **Category:** email
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `MAILVERI`
- **Version:** 00000000_00

## Tools

### Delete Batch

**Slug:** `MAILVERI_DELETE_BATCH`

Cancel an active MailVeri verification batch or permanently delete a completed batch and all of its stored results. This destructive operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_id` | string | Yes | Batch job ID to cancel if processing or permanently delete with all stored results if complete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Batch CSV

**Slug:** `MAILVERI_DOWNLOAD_BATCH_CSV`

Download selected statuses from a completed verification batch as a CSV using the requested column layout.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `columns` | string ("original" | "compact" | "email") | No | CSV layout: original preserves source columns and appends status, compact returns Email and Status, and email returns only Email. |
| `batch_id` | string | Yes | Completed batch job ID returned by Start Batch Verification. |
| `statuses` | array | No | Verification statuses to include in the CSV. Defaults to VALID and ROLE_ACCOUNT. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Batch ZIP

**Slug:** `MAILVERI_DOWNLOAD_BATCH_ZIP`

Download a completed verification batch as a ZIP archive containing the full categorized result lists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_id` | string | Yes | Completed batch job ID returned by Start Batch Verification. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Balance

**Slug:** `MAILVERI_GET_ACCOUNT_BALANCE`

Return the connected MailVeri account's remaining verification credits without purchasing or changing credits.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Batch Status

**Slug:** `MAILVERI_GET_BATCH_STATUS`

Return a MailVeri verification batch's current processing progress and its result download URL when complete. This performs one status read and does not poll repeatedly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_id` | string | Yes | Batch job ID returned by Start Batch Verification. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Batch Verification

**Slug:** `MAILVERI_START_BATCH_VERIFICATION`

Upload a TXT or CSV file and queue an asynchronous email-verification batch. Each unique email consumes one account credit; UNKNOWN results are refunded. Do not retry after an ambiguous transport failure because the batch may already have been queued and credits may have been consumed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | TXT or CSV file containing 2 to 1,000,000 unique email addresses, up to 100 MB. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Email

**Slug:** `MAILVERI_VERIFY_EMAIL`

Verify one email address and return its deliverability verdict and quality signals. A conclusive result consumes one MailVeri account credit; UNKNOWN and failed verifications consume no credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
