Email Address Validation - Single

Verify individual email addresses for deliverability and validity. Returns detailed results including whether the email is valid, invalid, disposable, or a catch-all, along with optional address metadata and account credit balance.

Actions

verify

Validate a single email address and get a deliverability result.

Required Fields:

• action (string): "verify"
• email (string): The email address to verify

Optional Fields:

• address_info (boolean, default: true): Include additional address metadata (e.g., free email provider, role account detection)
• credits_info (boolean, default: true): Include remaining credit balance in the response
• timeout (integer, default: 10, range: 1-30): Request timeout in seconds

Example - Basic verification:

{
  "action": "verify",
  "email": "jane.doe@example.com"
}

Example - Verification without extra metadata:

{
  "action": "verify",
  "email": "support@company.org",
  "address_info": false,
  "credits_info": false
}

Example - Verification with extended timeout:

{
  "action": "verify",
  "email": "user@slow-mail-server.net",
  "timeout": 25
}

Response Fields

• email: The email address that was checked
• result: Verification result (e.g., "valid", "invalid", "disposable", "catchall", "unknown")
• flags: Array of flags providing additional context about the address
• suggested_correction: A suggested spelling correction if a typo is detected (or null)
• execution_time: Time taken to verify the address in milliseconds
• address_info (when enabled): Additional metadata about the address such as whether it is a free provider or role account
• credits_info (when enabled): Remaining verification credits on the account

Common Workflows

1. Pre-send email validation: Verify an email address before sending a message to reduce bounces.
2. Form input validation: Check an email submitted through a signup or contact form for deliverability.
3. CRM data hygiene: Spot-check individual contacts in a CRM to confirm addresses are still valid.
4. Typo detection: Use the suggested_correction field to catch common misspellings (e.g., "gmial.com" -> "gmail.com").

Important Notes

• Each verification consumes one credit.
• Results are real-time checks against the mail server; transient server issues may return "unknown".
• For verifying large batches of emails, use the bulk email verification product instead.
• The timeout parameter controls how long to wait for the remote mail server to respond. Increase it for servers known to be slow.