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

# Emailvalidation

Validate individual email addresses for deliverability and quality signals, and inspect account quota usage through emailvalidation.io's complete REST API surface.

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

## Tools

### Get Account Quota Status

**Slug:** `EMAILVALIDATION_GET_ACCOUNT_QUOTA_STATUS`

Return the connected emailvalidation.io account ID and current monthly and grace credit totals, usage, and remaining balances. This status check does not consume validation credits or count against the API rate limit.

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

### Validate Email Address

**Slug:** `EMAILVALIDATION_VALIDATE_EMAIL_ADDRESS`

Validate one email address and return deliverability, format, mailbox, domain, role-address, disposable-address, and quality signals. Each successful validation costs one account credit. Catch-all detection is optional, disabled by default, and requires a Small or higher plan; requesting it on an unsupported plan can still consume one credit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The single email address to validate. |
| `catch_all` | boolean | No | Whether to run catch-all domain detection. Defaults to false. Enable only when the connected account is on Small or higher; unsupported requests can still consume one credit. |

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