Analyze Email
POST/email/analyze
The Analyze Email endpoint validates an email address and returns its deliverability status, provider details, and potential corrections. This endpoint is ideal for ensuring accurate email data before usage.
Features:
- Validate email syntax.
- Identify email types (free, disposable, private or unknown).
- Real time verifications:
- Reachable: Confirms if the email domain has valid MX DNS records using DNS lookup.
- Deliverable: Simulates an SMTP handshake to check if the email address exists and is deliverable.
- Catch-All: Detects if the domain accepts all emails (catch-all configuration).
- Intelligent Error Correction: Automatically corrects well-known misspelled email addresses.
- Risk Report: Provides an AI-driven normalized score (200-1000) to evaluate email risk, using predefined thresholds.
Example Request Body:
{
"email": "my-email@company.com",
"enableAI": true,
"enableAutoCorrection": true
}
Authentication & Security
- API Key: Access to the API requires an API key, which must be included in the request headers. Businesses can generate unlimited API keys directly from their account, offering flexibility and ease of use.
- ACL Rules: Enhance security with Access Control Lists (ACL), allowing you to restrict API access from specific IP addresses or ranges. This feature provides an additional layer of protection by ensuring only authorized IPs can interact with the API.
- No Query Parameters: As a precautionary measure, our API avoids the use of query parameters for all operations, including authentication and handling Personally Identifiable Information (PII). This approach minimizes security risks by preventing sensitive data from being exposed in access logs, browser history, cached URLs, debugging tools, or inadvertently shared URLs. All sensitive information is securely transmitted through headers or the request body.
Request
Responses
- 200
- 400
- 403
- 500
Email validation successful.
Bad Request. Either the request is improperly formatted, or the email is invalid.
Forbidden
Internal server error.