## SmartFix Email Edge A high-performance email verification API running on the Cloudflare Global Edge Network. SmartFix validates adresses via live DNS/MX checks, flagging disposable "burner" emails (even those hiding behind subdomains), and suggesting real-time typo corrections. Built for developers who need low-latency validation for client-side forms and scalable parallel processing (up to 50 emails per request) for backend bulk cleaning. --- ### Why SmartFix? **Smart Conversion Logic** :
SmartFix differentiates between fraudulent entries and accidental typo. If an address has a typo but the domain is technically active. The system provide a suspect_typo flag and a did_you_mean suggestion.
**You Hold the Key**: Since the domain is valid and not a disposable provider, we give you the flexibility to accept the lead or prompt the user for a real-time correction.
**Hygiene vs. Conversion**: You choose the balance. Whether you want a strict accepts or a frictionless signup, we provide the metadata to power your logic.
**Stop Ghost Lead**s: Automatically reject disposable/burner emails (like Mailinator) that ruin your sender reputation and inflate your marketing costs.
**Reliable Disposable Detection**: SmartFix leverages a constantly synchronized and highly curated engine to identify temporary domains. By intercepting even the most recent burner providers, we ensure your lead quality remains uncompromised and your deliverability stays peak **Edge Performance**: Powered by Cloudflare, processing requests at the server closest to your user for zero-lag integration. **B2B Intelligence**: Instantly detect role-based accounts (info@, admin@)
**High-Availability DNS**: Using multi-provider DNS-over-HTTPS strategy to ensure MX lookups are performed with 99.9% reliability, even if one provider experiences downtime. ----------- ### Key Features * **Syntax Check:** Fast-fail regex check to filter out malformed strings before they hit your database * **Typo Correction:** Advanced algorithm to catch "fat-finger" errors (e.g., `gmil.com` → `gmail.com`). * **MX Record Lookup:** Real-time verification via DNS-over-HTTPS to ensure the domain can receive mail. * **Disposable & Burner Shield:** Automatically blocks temporary email providers using a dynamically updated global list
Bi-Hourly Intelligence Sync: The system syncs with global databases every 2 hours to catch desposable domains and stealth burner domains.
* **Role Detection (B2B):** Identifies generic accounts like `info@`, `admin@`, or `sales@` for better lead qualification.. * **Confidence Scoring:** Returns a 0-100 score based on multiple signals, allowing you to set your own threshold for user registration.
* **Freemail Identification**: Detects if the address belongs to a major free provider (Gmail, Outlook, Yahoo, iCloud, etc.), helping you distinguish between personal and professional leads. * **Parallel Bulk Processing**: Validate up to 50 email addresses in a single request. The system uses an asynchronous parallel engine, delivering results nearly as fast as a single validation * **Instant Single Validation** : Ideal for client-side forms and real-time verification * **Subdomain Detection**: Extracts the root domain from any subdomain to accurately catch and flag temporary/disposable emails. ----------- **Authentication**
****All API requests** require the following headers**:
**Content-Type**: application/json
**x-rapidapi-hos**t: smartfix-email-edge.p.rapidapi.com
**x-rapidapi-key** : Your RapidAPI key
**Example headers**:
-H "Content-Type: application/json"
-H "x-rapidapi-host: smartfix-email-edge.p.rapidapi.com"
-H "x-rapidapi-key: YOUR_RAPIDAPI_KEY"

### Integration Guide
**Endpoints**:
**POST** ****FastValidation****
This endpoint use a JSON payload
**Payload Description**:
JSON
{
"email":"mario.rossi@gmil.com"
}
**Response Example**:
JSON
{
"email": "mario.rossi@gmil.com",
"valid": false,
"score": 10,
"reason": "reject_disposable",
"did_you_mean": "mario.rossi@gmail.com",
"details": {
"syntax_valid": true,
"mx_valid": true,
"is_disposable": true,
"is_freemail": false,
"is_suspicious": true,
"is_role_account": false,
is_subdomain: false,
root_domain:"gmil.com"
}, "execution_time_ms": 22
}
**POST FastBulkValidation**
Validate multiple email addresses in a single request. The system processes up to 50 emails in parallel using Edge Computing, ensuring ultra-fast response times for large lists.
Example Payload:
JSON
{
"emails": [
"mario.rossi@gmail.com",
"test@dontexist.com",
"suser@10minutemail.com",
"info@hotmail.com"
]
} ----------- ### Field Definitions **email -> String** : The processed email address, sanitized (trimmed and converted to lowercase).
**valid -> Boolean** : Technical delivery status. Returns true if the domain has valid MX records and is not disposable.
**score -> Integer** : A proprietary quality score (0-100) based on syntax, deliverability, and domain reputation.
**reason ->String** : A readable status code for the verification outcome (e.g., accept, suspect_typo, reject_disposable).
**did_you_mean -> String | null** : Suggested domain correction if a potential typo is detected (e.g., gmil.com → gmail.com).
**execution_time_ms -> Integer**: Total server-side processing time in milliseconds.

**Details**: **syntax_valid -> Boolean**: Indicates if the string conforms to standard RFC email formatting.
**mx_valid -> Boolean**: Confirms if the domain has valid Mail Exchanger (MX) records.
**is_disposable -> Boolean**: true if the domain is identified as a temporary or "burner" email provider.
**is_freemail -> Boolean**: true if the domain belongs to a major free provider (e.g., Gmail, Yahoo, Outlook).
**is_suspicious -> Boolean**: true if the domain is flagged as phishing attempt .
**is_role_account -> Boolean**: true if the prefix is a functional/business role (e.g., info@, admin@, support@).
**is_subdomain** **-> Boolean**: true if the email address uses a subdomain instead of the main root domain. **root_domain -> String**: The identified primary domain. ----------- **Reason Codes Explained:**
**accept**: High-quality personal email.
**suspect_typo**: Valid domain, but highly likely a typosquatting or phishing attempt
**accept_role_accoun**t: Valid email but belongs to a generic/functional group (B2B).
**reject_disposable**: Blocked. Temporary/Burner email provider.
**reject_invalid_domain**: Blocked. Domain does not exist or has no mail servers.
**reject_format**: Blocked. Failed basic syntax validation.
----------- **Score Interpretation Guide**:
**100-> Excellent**: Perfect syntax, valid MX, not disposable. Safe to send.
**60 -> Warning**: The email works (MX OK), but it is likely misspelled or suspicious.
**Below 60 -> Rejected**: The email is either a disposable burner address or it has an invalid/missing MX record or invalid syntax. ---- ### Error Codes **400 Bad Request**: Missing email field or malformed JSON. **401 Unauthorized**: Missing or incorrect API key **404 Not Found**: Resource not found. **500 Internal Error**: Rare processing error at the Edge.