## MailSentinel: Enterprise-Grade Email Verification **Version: 1.0.4** **Status: Stable** MailSentinel is a high-performance email validation engine designed to protect your sender reputation and reduce bounce rates. Unlike simple syntax checkers, MailSentinel performs real-time MX-record lookups and identifies disposable email providers to ensure your users are real. ### 🚀 Key Features MailSentinel has the following key features: 1. Syntax Validation: Full RFC-compliant checks to ensure email formatting is correct. 2. MX Record Verification: Real-time DNS queries to confirm the domain can actually receive mail. 3. Disposable Detection: Automatically flags burner emails (e.g., 10-minute mail) to prevent trial abuse. 4. Batch Processing: Clean up to 100 emails in a single request for enterprise workflows. 5. Ultra-Low Latency: Optimized Python backend designed for sub-100ms response times. All requests must be authenticated via the RapidAPI Gateway. - `Header Name: X-RapidAPI-Key` - `Header Name: X-RapidAPI-Host` ________________________________________ ### 📡 Endpoint Reference

Endpoint	Method	Description	Access Tier
/verify	GET	Basic syntax + MX record check	All Tiers
/verify/deep	GET	Syntax + MX + Disposable detection	Pro / Ultra
/verify/batch	POST	Bulk processing (up to 100 emails)	Ultra / Mega

#### Basic Verification (GET /verify) The standard check for sign-up forms. Validates format and mail server existence. - Best for: Real-time registration forms. - Data Returned: Syntax status, MX status, and Domain info. Parameters:
- email (string): The email address to validate. Success Response (200 OK): JSON ``` { "email": "user@gmail.com", "status": "valid", "details": { "syntax_valid": true, "mx_records_found": true, "domain": "gmail.com" } } ``` #### Deep Verification (GET /verify/deep) Identifies if an email is a "burner" account used for trial abuse. Our premium security check. Adds a layer of protection against temporary/burner emails. - Best for: Preventing fraud, trial abuse, and spam bots. - Data Returned: All basic info + `is_disposable` flag and Risk Score. #### Batch Verify (POST /verify/batch) Designed for bulk list cleaning. Process 100 emails at once. - Best for: CRM cleaning and large marketing list preparation. #### Error Handling MailSentinel uses standard HTTP response codes: - 200 OK: Request successful. - 400 Bad Request: Missing parameters or malformed email. - 401 Unauthorized: Invalid API Key. - 429 Too Many Requests: Rate limit exceeded for your current tier. ________________________________________ ### 💡 Best Practices *Caching*: MailSentinel employs internal caching for 24 hours. If you query the same email multiple times within a day, you will receive a cached result to ensure maximum speed. *Rate Limiting*: To maintain high availability, we recommend implementing a "Retry-After" logic in your application if you encounter a 429 status code. ________________________________________ ### 🆘 Support & SLAs** - Basic/Pro Users: Community support via the RapidAPI "Discussions" tab. - Ultra/Mega Users: Priority email support with a 4-hour response window. - Contact: support@nullconsulting.com