# Emaillistverify

EmailListVerify is a service that provides email verification and validation to ensure email lists are clean and deliverable.

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `EMAILLISTVERIFY`
- **Version:** 20260312_00

## Tools

### Check Blacklists

**Slug:** `EMAILLISTVERIFY_CHECK_BLACKLISTS`

Tool to check an IP address (IPv4/IPv6) or domain against multiple DNS-based blacklists (DNSBLs) for spam or malicious activity. Use when you need to verify the reputation of an IP or domain. Rate limit: 10 requests/second.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `value` | string | Yes | The IP address (IPv4/IPv6) or domain to check against DNS-based blacklists (DNSBLs) |

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

### Check Disposable Domain

**Slug:** `EMAILLISTVERIFY_CHECK_DISPOSABLE`

Tool to verify if an email domain is associated with temporary/disposable email addresses. Includes DNS record verification. Use when you need to validate if a domain is disposable before accepting email registrations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | The email domain to check for disposability |

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

### Delete Maillist

**Slug:** `EMAILLISTVERIFY_DELETE_MAILLIST`

Tool to delete a finished email list. Use when you need to remove a completed verification list. Only lists that have completed verification can be deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the finished email list to delete |

#### 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 Email List

**Slug:** `EMAILLISTVERIFY_DOWNLOAD_MAILLIST`

Tool to download a finished email list with verification results. Supports customizable columns (firstName, lastName, gender, result, etc.) and file format (csv/xlsx). Rate limit: 5 requests/second.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the finished email list to download |
| `addEsp` | string | No | Adds a column 'ELV ESP' displaying the Email Service Provider associated with the email's domain. Use 'true' or 'false'. |
| `format` | string ("csv" | "xlsx") | No | File format for the downloaded email list. |
| `results` | string | No | Filter rows by verification result. Comma-separated list of deliverability statuses (e.g., 'ok,email_disabled,antispam_system'). Defaults to all possible statuses. |
| `addEmail` | string | No | Adds a column 'ELV Email' displaying the exact email used as input during verification. Use 'true' or 'false'. |
| `addGender` | string | No | Adds a column 'ELV Gender' with an estimation of the gender of the person associated with the email address. Use 'true' or 'false'. |
| `addIsFree` | string | No | Adds a column 'ELV Is Free' indicating if a free email account can be created using the same domain. Use 'true' or 'false'. |
| `addIsRole` | string | No | Adds a column 'ELV Is Role' to signify if the email pertains to a business role (e.g., info, support). Use 'true' or 'false'. |
| `addResult` | string | No | Adds a column 'ELV Result' displaying the verification result of the email. Use 'true' or 'false'. |
| `addLastName` | string | No | Adds a column 'ELV Last Name' with an estimation of the last name of the person associated with the email address. Use 'true' or 'false'. |
| `addMxServer` | string | No | Adds a column 'ELV MX Server' displaying the MX server associated with the email's domain. Use 'true' or 'false'. |
| `addOriginal` | string | No | Includes all columns from the uploaded file that do not contain email information (e.g., Phone, Address). Use 'true' or 'false'. |
| `addFirstName` | string | No | Adds a column 'ELV First Name' with an estimation of the first name of the person associated with the email address. Use 'true' or 'false'. |
| `addIsNoReply` | string | No | Adds a column 'ELV Is No Reply' with values denoting whether the email's inbox is actively monitored. Use 'true' or 'false'. |
| `addDuplicates` | string | No | If 'false', eliminates duplicate emails, retaining only the first occurrence. Use 'true' or 'false'. |
| `addNoEmailRows` | string | No | Adds rows that do not contain precisely one email and cannot undergo verification. Use 'true' or 'false'. |
| `addInternalResult` | string | No | Adds a column 'ELV Internal Result' displaying the internal verification result. Use 'true' or 'false'. |

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

### Find Contact Email

**Slug:** `EMAILLISTVERIFY_FIND_CONTACT`

Tool to search for a contact's business email address by name and company domain. Returns possible emails with confidence levels (high/medium/low/unknown). Rate limit: 5 requests/second. Credits: 5 (with name) or 10 (domain only).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Email domain of the contact's company (e.g., 'connelycorp.com'). This field is required. |
| `lastName` | string | No | Last name of the contact. Optional but improves accuracy and reduces credit cost (5 credits with name vs 10 without). |
| `firstName` | string | No | First name of the contact. Optional but improves accuracy and reduces credit cost (5 credits with name vs 10 without). |

#### 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 API File Info

**Slug:** `EMAILLISTVERIFY_GET_API_FILE_INFO`

Tool to retrieve progress of an uploaded email list verification. Returns status (errored/waiting/progress/finished) with download URLs when complete.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the successfully uploaded email list |

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

**Slug:** `EMAILLISTVERIFY_GET_CREDITS`

Tool to retrieve details about available on-demand and subscription credits. Use when you need to check credit balance before performing verifications. On-demand credits never expire, subscription credits are refreshed daily. Rate limit: 10 requests/second.

#### 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 Email Job Status

**Slug:** `EMAILLISTVERIFY_GET_EMAIL_JOB`

Tool to get the status of an asynchronous email verification job. Use when you need to check if a verification job has completed and retrieve its results. Rate limit: 100 requests per second.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the email verification job to retrieve |

#### 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 Maillist Progress

**Slug:** `EMAILLISTVERIFY_GET_MAILLIST_PROGRESS`

Tool to retrieve real-time progress updates for an uploaded email list verification. Shows status, completion percentage, and credit usage. Rate limit: 100 requests/second.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the email list to retrieve progress for |

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

### Upload Email List

**Slug:** `EMAILLISTVERIFY_UPLOAD_EMAIL_LIST`

Tool to upload an email list file for bulk verification. Accepts .csv, .txt, or .xlsx files (max 100MB, 1M rows). Returns an ID to query verification progress. Rate limit: 5 requests/second.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `quality` | string ("standard" | "high") | No | Quality level for email verification. |
| `file_contents` | object | Yes | The email list file to upload (.csv.txt.xlsx). Max 100MB, 1M rows. |

#### 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 Single Email

**Slug:** `EMAILLISTVERIFY_VERIFY_SINGLE_EMAIL`

Tool to verify email deliverability status of a single email address. Returns a plain text status representing deliverability. Rate limit: 10 requests/second. Credits required: 1.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address that will be verified |

#### 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 Single Email Detailed

**Slug:** `EMAILLISTVERIFY_VERIFY_SINGLE_EMAIL_DETAILED`

Tool to verify email deliverability with detailed metadata including MX server info, ESP, first/last name estimation, gender, and role detection. Use when you need comprehensive email validation beyond basic deliverability. Rate limit: 10 requests/second, requires 1 credit per verification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address to be verified |

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