Logo

Email Verification – Validate & Check Disposable Emails

Data APIs

Verify email addresses in real time with syntax validation, MX record checks, SMTP mailbox verification, disposable email detection, catch-all detection, spam risk analysis, and deliverability scoring.

About this API


Email Verification – Validate & Check Disposable Emails Endpoints
GET Version 1.0 1 Credit

Verify

Verify email addresses in real time with syntax validation, MX record checks, SMTP mailbox verification, disposable email detection, catch-all detection, spam risk analysis, and deliverability scoring.

Ready to query this endpoint?

Sign up to get a free API key instantly with sandbox test credits. No card required.

Request Details

Endpoint URL
GET https://apipeak.dev/api/emailvalidation/verify
Request Parameters
Parameter Type Requirement Description
email string Required provide the email address
Documentation

📧 Email Validation API

Validate an email address and retrieve syntax, domain, mailbox, provider, and risk information.

🔗 Endpoint

GET https://apipeak.dev/api/emailvalidation/[email protected]

cURL Request

curl -X GET "https://apipeak.dev/api/emailvalidation/[email protected]" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"

🔐 Authentication

Include your API key in the X-API-KEY request header.

X-API-KEY: YOUR_API_KEY
Content-Type: application/json

📝 Query Parameters

Parameter Type Example Description
email String [email protected] The email address to validate.

📦 Example Response

{
  "email": "[email protected]",
  "normalized_email": "[email protected]",
  "status": "valid",
  "score": 85,
  "checks": {
    "syntax": true,
    "domain_exists": true,
    "mx_found": true,
    "mailbox_exists": true,
    "smtp_checked": true,
    "catch_all": false,
    "disposable": false,
    "free_provider": false,
    "role_address": true
  },
  "domain": {
    "name": "vebapi.com",
    "mail_provider": "Google Workspace",
    "mx_records": [
      "smtp.google.com"
    ]
  },
  "suggestion": null,
  "risk": {
    "level": "low",
    "reason": "role_address"
  },
  "processing_time_ms": 415
}

📋 Response Fields

Field Type Description
email String The submitted email address.
normalized_email String The normalized email address.
status String The email validation status.
score Integer The email validation score.
checks Object Contains individual email validation checks.
checks.syntax Boolean Indicates whether the email syntax is valid.
checks.domain_exists Boolean Indicates whether the email domain exists.
checks.mx_found Boolean Indicates whether MX records were found.
checks.mailbox_exists Boolean Indicates whether the mailbox exists.
checks.smtp_checked Boolean Indicates whether an SMTP check was performed.
checks.catch_all Boolean Indicates whether the domain accepts email for any mailbox.
checks.disposable Boolean Indicates whether the address uses a disposable email provider.
checks.free_provider Boolean Indicates whether the address uses a free email provider.
checks.role_address Boolean Indicates whether the address is role-based.
domain Object Contains information about the email domain.
domain.name String The email domain name.
domain.mail_provider String The detected mail service provider.
domain.mx_records Array A list of MX records associated with the domain.
suggestion String or Null A suggested email correction when available.
risk Object Contains email risk information.
risk.level String The detected risk level.
risk.reason String or Null The reason associated with the risk assessment.
processing_time_ms Integer The request processing time in milliseconds.

🚦 HTTP Status Codes

Status Code Description
Not provided No HTTP status codes were specified for this endpoint.

💡 Common Use Cases

  • Validate email addresses during registration.
  • Reduce invalid addresses in mailing lists.
  • Detect disposable and role-based email addresses.
  • Check domain, mailbox, and mail provider information.
  • Assess email quality before sending messages.
Request Example (cURL)
curl -X GET "https://apipeak.dev/api/emailvalidation/[email protected]" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Expected JSON Response
{
    "email": "[email protected]",
    "normalized_email": "[email protected]",
    "status": "valid",
    "score": 85,
    "checks": {
        "syntax": true,
        "domain_exists": true,
        "mx_found": true,
        "mailbox_exists": true,
        "smtp_checked": true,
        "catch_all": false,
        "disposable": false,
        "free_provider": false,
        "role_address": true
    },
    "domain": {
        "name": "vebapi.com",
        "mail_provider": "Google Workspace",
        "mx_records": [
            "smtp.google.com"
        ]
    },
    "suggestion": null,
    "risk": {
        "level": "low",
        "reason": "role_address"
    },
    "processing_time_ms": 415
}
GET Version 1.0 1 Credit

Disposable Check

Verify email addresses in real time with syntax validation, MX record checks, SMTP mailbox verification, disposable email detection, catch-all detection, spam risk analysis, and deliverability scoring.

Ready to query this endpoint?

Sign up to get a free API key instantly with sandbox test credits. No card required.

Request Details

Endpoint URL
GET https://apipeak.dev/api/emailvalidation/disposable
Request Parameters
Parameter Type Requirement Description
email string Required provide the email address
Documentation

🗑️ Disposable Email Check API

Check whether an email address belongs to a disposable email provider.

🔗 Endpoint

GET https://apipeak.dev/api/emailvalidation/[email protected]

cURL Request

curl -X GET "https://apipeak.dev/api/emailvalidation/[email protected]" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"

🔐 Authentication

Include your API key in the X-API-KEY request header.

X-API-KEY: YOUR_API_KEY
Content-Type: application/json

📝 Query Parameters

Parameter Type Example Description
email String [email protected] The email address to check.

📦 Example Response

{
    "email": "[email protected]",
    "domain": "vebapi.com",
    "syntax_valid": true,
    "disposable": false,
    "free_provider": false,
    "provider_type": "custom",
    "blocklist_size": 74963,
    "processing_time_ms": 2
}

📋 Response Fields

Field Type Description
email String The submitted email address.
domain String The email domain.
syntax_valid Boolean Indicates whether the email syntax is valid.
disposable Boolean Indicates whether the domain is a disposable email provider.
free_provider Boolean Indicates whether the email uses a free email provider.
provider_type String The detected provider type.
blocklist_size Integer The number of disposable domains in the blocklist.
processing_time_ms Integer The request processing time in milliseconds.

🚦 HTTP Status Codes

Status Code Description
Not provided No HTTP status codes were specified for this endpoint.

💡 Common Use Cases

  • Block disposable email addresses during user registration.
  • Reduce fake account creation.
  • Validate sign-ups before sending verification emails.
  • Detect free and custom email providers.
  • Improve the quality of customer email lists.
Request Example (cURL)
curl -X GET "https://apipeak.dev/api/emailvalidation/[email protected]" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Expected JSON Response
{
    "email": "[email protected]",
    "domain": "vebapi.com",
    "syntax_valid": true,
    "disposable": false,
    "free_provider": false,
    "provider_type": "custom",
    "blocklist_size": 74963,
    "processing_time_ms": 2
}
GET Version 1.0 1 Credit

Spam Score

Verify email addresses in real time with syntax validation, MX record checks, SMTP mailbox verification, disposable email detection, catch-all detection, spam risk analysis, and deliverability scoring.

Ready to query this endpoint?

Sign up to get a free API key instantly with sandbox test credits. No card required.

Request Details

Endpoint URL
GET https://apipeak.dev/api/emailvalidation/spam-score
Request Parameters
Parameter Type Requirement Description
email string Required provide the email address
Documentation

🚩 Email Spam Score API

Analyze an email address and return its spam score, trust score, and risk indicators.

🔗 Endpoint

GET https://apipeak.dev/api/emailvalidation/[email protected]

cURL Request

curl -X GET "https://apipeak.dev/api/emailvalidation/[email protected]" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"

🔐 Authentication

Include your API key in the X-API-KEY request header.

X-API-KEY: YOUR_API_KEY
Content-Type: application/json

📝 Query Parameters

Parameter Type Example Description
email String [email protected] The email address to analyze.

📦 Example Response

{
    "email": "[email protected]",
    "normalized_email": "[email protected]",
    "spam_score": 0,
    "trust_score": 100,
    "risk_level": "low",
    "indicators": {
        "invalid_syntax": false,
        "disposable": false,
        "no_mx_records": false,
        "catch_all_domain": false,
        "role_account": true,
        "free_provider": false,
        "possible_typo_domain": false,
        "mailbox_verified": true
    },
    "flags": [
        "role_account"
    ],
    "domain": {
        "name": "vebapi.com",
        "mail_provider": "Google Workspace",
        "mx_records": [
            "smtp.google.com"
        ]
    },
    "suggestion": null,
    "processing_time_ms": 315
}

📋 Response Fields

Field Type Description
email String The submitted email address.
normalized_email String The normalized email address.
spam_score Integer The calculated spam score.
trust_score Integer The calculated trust score.
risk_level String The overall risk level.
indicators Object Contains individual spam and trust indicators.
indicators.invalid_syntax Boolean Indicates whether the email syntax is invalid.
indicators.disposable Boolean Indicates whether the email uses a disposable provider.
indicators.no_mx_records Boolean Indicates whether no MX records were found.
indicators.catch_all_domain Boolean Indicates whether the domain is configured as catch-all.
indicators.role_account Boolean Indicates whether the address is role-based.
indicators.free_provider Boolean Indicates whether the email uses a free provider.
indicators.possible_typo_domain Boolean Indicates whether the domain appears to contain a typo.
indicators.mailbox_verified Boolean Indicates whether the mailbox was verified.
flags Array A list of triggered risk flags.
domain Object Contains information about the email domain.
domain.name String The email domain name.
domain.mail_provider String The detected mail service provider.
domain.mx_records Array A list of MX records associated with the domain.
suggestion String or Null A suggested email correction when available.
processing_time_ms Integer The request processing time in milliseconds.

🚦 HTTP Status Codes

Status Code Description
Not provided No HTTP status codes were specified for this endpoint.

💡 Common Use Cases

  • Assess the quality of email addresses before registration.
  • Filter high-risk or suspicious email addresses.
  • Improve email list quality.
  • Detect disposable, catch-all, and role-based email addresses.
  • Reduce spam and fake account creation.
Request Example (cURL)
curl -X GET "https://apipeak.dev/api/emailvalidation/[email protected]" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Expected JSON Response
{
    "email": "[email protected]",
    "normalized_email": "[email protected]",
    "spam_score": 0,
    "trust_score": 100,
    "risk_level": "low",
    "indicators": {
        "invalid_syntax": false,
        "disposable": false,
        "no_mx_records": false,
        "catch_all_domain": false,
        "role_account": true,
        "free_provider": false,
        "possible_typo_domain": false,
        "mailbox_verified": true
    },
    "flags": [
        "role_account"
    ],
    "domain": {
        "name": "vebapi.com",
        "mail_provider": "Google Workspace",
        "mx_records": [
            "smtp.google.com"
        ]
    },
    "suggestion": null,
    "processing_time_ms": 315
}

Flexible Subscriptions

Choose the monthly credit subscription that supports your development throughput. Cancel or shift tiers at any time.

FREE

Perfect for exploring the API

$0 /month
  • 50 requests per month
  • Developer Sandbox Credentials
  • Instant API Key Activation

PRO

Best for small projects

$7 /month
  • 50,000 requests per month
  • Developer Sandbox Credentials
  • Instant API Key Activation

ULTRA

Ideal for SaaS products and tools

$15 /month
  • 250,000 requests per month
  • Developer Sandbox Credentials
  • Instant API Key Activation

MEGA

Built for agencies and businesses

$29 /month
  • 600,000 requests per month
  • Developer Sandbox Credentials
  • Instant API Key Activation