# Verifiedemail

VerifiedEmail offers real-time email verification and bulk email list cleaning services to ensure the accuracy and deliverability of email communications.

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `VERIFIEDEMAIL`
- **Version:** 20260316_00

## Tools

### Check Credits

**Slug:** `VERIFIEDEMAIL_CHECK_CREDITS`

Tool to retrieve the remaining verification credits. Call before VERIFIEDEMAIL_VERIFY_EMAIL operations—especially in bulk or repeated workflows—as VERIFIEDEMAIL_VERIFY_EMAIL fails immediately when credits are exhausted. Use after confirming account authentication to ensure sufficient credits before proceeding.

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

**Slug:** `VERIFIEDEMAIL_CHECK_FILE_STATUS`

Tool to check the status of a previously uploaded file. Use after uploading a file when polling for verification progress.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The ID of the file returned by the upload endpoint. |

#### 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 1-Click User Data

**Slug:** `VERIFIEDEMAIL_GET1_CLICK_USER_DATA`

Tool to retrieve data for a user who has completed a 1-Click Signup flow. Use after you have the identityUuid to fetch the verified user's full profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identityUuid` | string | Yes | The unique identifier for the user, obtained from the SDK or as a URL parameter on the redirect URL |

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

**Slug:** `VERIFIEDEMAIL_GET_ENTITLEMENTS`

Tool to retrieve information about available credits across different entitlement types. Use when you need to check credit availability before performing operations that consume 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 Shared Credentials

**Slug:** `VERIFIEDEMAIL_GET_SHARED_CREDENTIALS`

Tool to retrieve a list of shared credential IDs. Use when you need to fetch all credentials shared to your account after authentication.

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

### List Downloads

**Slug:** `VERIFIEDEMAIL_LIST_DOWNLOADS`

Tool to get a list of previously created download requests. Use when you need to retrieve information about download requests that have been created for verification results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | string | No | Number of items to return. |
| `offset` | string | No | Number of items to offset the result set by. |
| `sortField` | string | No | Sort field for ordering results (e.g., 'dateAdded'). |
| `sortOrder` | string | No | Sort order for results. Options: 'desc' (descending), 'asc' (ascending). |

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

### List Lists

**Slug:** `VERIFIEDEMAIL_LIST_LISTS`

Tool to get all email lists in your account. Use when you need to retrieve and view all verification lists with optional pagination and sorting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | string | No | Number of items to return. |
| `offset` | string | No | Number of items to offset the result set by. |
| `sortField` | string | No | Sort field for ordering the results. |
| `sortOrder` | string | No | Sort order for results (e.g., 'asc' for ascending, 'desc' for descending). |

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

### Update 1-Click Credentials

**Slug:** `VERIFIEDEMAIL_POST1_CLICK_CREDENTIALS_UPDATE`

Tool to update 1-Click credentials. Use after obtaining a 1-Click session uuid when you need to update user-provided credential values in a non-hosted or trusted flow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | The unique identifier for the 1-Click session |
| `credentials` | object | Yes | An object containing the updated credential values. Keys are credential names and values are either simple strings or nested objects. |

#### 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:** `VERIFIEDEMAIL_VERIFY_EMAIL`

Tool to verify the deliverability and validity of an email address. Use when you need to confirm if an email can receive mail by checking server existence, mailbox status, and more. For bulk use, call VERIFIEDEMAIL_CHECK_CREDITS first — this tool fails if verification credits are exhausted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The 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 |