{"_id":"@emailcheck/disposable-email-providers","name":"@emailcheck/disposable-email-providers","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@emailcheck/disposable-email-providers","version":"1.0.0","private":false,"description":"A list of Disposable email providers in JSON format","keywords":["email","disposable","providers"],"repository":{"type":"git","url":"git+https://github.com/email-check-app/disposable-email-providers.git"},"license":"MIT","author":{"name":"EMAIL-CHECK.APP","email":"support@email-check.app","url":"https://email-check.app"},"packageManager":"yarn@1.22.22","gitHead":"ca14eebf70cdf5a1caac5a3f51e069bf24e186ac","_id":"@emailcheck/disposable-email-providers@1.0.0","bugs":{"url":"https://github.com/email-check-app/disposable-email-providers/issues"},"homepage":"https://github.com/email-check-app/disposable-email-providers#readme","_nodeVersion":"24.11.1","_npmVersion":"11.6.3","dist":{"integrity":"sha512-sRCdnuL9LvrJxXjFhBiB7cP3QKf2/DbzsysP18lJD2NQAvdRhMvuvllayh06Kq9qjgX7b1mQ4Ing7OJDOC6hbQ==","shasum":"fad3d408df6d9dd6149371e42601a3926c9580d1","tarball":"https://registry.npmjs.org/@emailcheck/disposable-email-providers/-/disposable-email-providers-1.0.0.tgz","fileCount":4,"unpackedSize":3482108,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDMbRFNGTlGc+5bsyf1f2+NTXNIztgkkk4BfeCf6zL/FAiAKV4kwP7iQ5M+4M2tWMX0InGjV1Dymv5q7Kskz7P8jdA=="}]},"_npmUser":{"name":"meabed","email":"mo.meabed@gmail.com"},"directories":{},"maintainers":[{"name":"meabed","email":"mo.meabed@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/disposable-email-providers_1.0.0_1763797814827_0.7359919770736885"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-22T07:50:14.761Z","1.0.0":"2025-11-22T07:50:15.087Z","modified":"2025-11-22T07:50:15.350Z"},"maintainers":[{"name":"meabed","email":"mo.meabed@gmail.com"}],"description":"A list of Disposable email providers in JSON format","homepage":"https://github.com/email-check-app/disposable-email-providers#readme","keywords":["email","disposable","providers"],"repository":{"type":"git","url":"git+https://github.com/email-check-app/disposable-email-providers.git"},"author":{"name":"EMAIL-CHECK.APP","email":"support@email-check.app","url":"https://email-check.app"},"bugs":{"url":"https://github.com/email-check-app/disposable-email-providers/issues"},"license":"MIT","readme":"# Disposable Email Providers List\n\n> A comprehensive, curated collection of disposable and temporary email provider domains for spam prevention, privacy protection, and email validation.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Last Updated](https://img.shields.io/github/last-commit/email-check-app/disposable-email-providers)](https://github.com/email-check-app/disposable-email-providers/commits/master)\n[![Size](https://img.shields.io/github/repo-size/email-check-app/disposable-email-providers)](https://github.com/email-check-app/disposable-email-providers)\n\n## 📋 Overview\n\nThis repository maintains an extensive, regularly updated list of disposable/temporary email provider domains. The data is aggregated from multiple reputable sources and carefully deduplicated to provide the most comprehensive collection available for:\n\n- **Email Validation**: Block disposable emails during user registration\n- **Spam Prevention**: Filter out temporary email addresses\n- **Compliance**: Meet anti-fraud and marketing requirements\n- **Development**: Test email functionality without using real addresses\n\n## 📊 Statistics\n\n- **Total Domains**: 259,095+ unique disposable email domains\n- **JSON Format**: 169,981 structured entries\n- **Text Format**: Simple domain list for easy integration\n- **Regular Updates**: Frequently maintained with new providers\n\n## 📁 Available Formats\n\n### JSON Format\n```bash\ndisposable-email-providers.json\n# Size: ~3.3MB\n# Entries: 169,981\n# Format: Array of domain strings\n```\n\n**Usage Example:**\n```javascript\nconst fs = require('fs');\nconst disposableDomains = JSON.parse(fs.readFileSync('disposable-email-providers.json', 'utf8'));\n\nfunction isDisposable(email) {\n  const domain = email.split('@')[1].toLowerCase();\n  return disposableDomains.includes(domain);\n}\n```\n\n**Usage Example:**\n```bash\n# Quick check using grep\ngrep -q \"domain.com\" list.txt && echo \"Disposable\" || echo \"Valid\"\n```\n\n## 🚀 Quick Start\n\n### JavaScript/Node.js\n```javascript\n// Using JSON format\nconst fs = require('fs');\nconst disposableEmails = JSON.parse(fs.readFileSync('disposable-email-providers.json', 'utf8'));\n\nfunction validateEmail(email) {\n  const domain = email.split('@')[1]?.toLowerCase();\n  return !disposableEmails.includes(domain);\n}\n\n// Example\nconsole.log(validateEmail('user@gmail.com')); // true\nconsole.log(validateEmail('user@10minutemail.com')); // false\n```\n\n### Python\n```python\nimport json\n\n# Load disposable domains\nwith open('disposable-email-providers.json', 'r') as f:\n    disposable_domains = set(json.load(f))\n\ndef is_valid_email(email):\n    try:\n        domain = email.split('@')[1].lower()\n        return domain not in disposable_domains\n    except IndexError:\n        return False\n\n# Example\nprint(is_valid_email('user@gmail.com'))  # True\nprint(is_valid_email('user@tempmail.org'))  # False\n```\n\n### PHP\n```php\n<?php\n// Load disposable domains\n$disposableDomains = json_decode(file_get_contents('disposable-email-providers.json'), true);\n\nfunction isDisposableEmail($email) {\n    $domain = strtolower(substr(strrchr($email, '@'), 1));\n    return in_array($domain, $disposableDomains);\n}\n\n// Example\nvar_dump(isDisposableEmail('user@gmail.com'));  // bool(false)\nvar_dump(isDisposableEmail('user@10minutemail.com'));  // bool(true)\n```\n\n## 🔄 Integration Examples\n\n### Using EMAIL-CHECKER.APP Email Validator (Recommended)\nFor a complete email validation solution, consider using [email-validator-js](https://github.com/email-check-app/email-validator-js/), which includes this disposable email list along with comprehensive validation:\n\n```bash\nnpm install @emailcheck/email-validator-js\n```\n\n```javascript\nconst { EmailValidator } = require('@emailcheck/email-validator-js');\n\nconst validator = new EmailValidator();\n\nasync function validateEmail(email) {\n  const result = await validator.validate(email);\n  return {\n    isValid: result.isValid,\n    isDisposable: result.isDisposable,\n    score: result.score,\n    details: result\n  };\n}\n\n// Example usage\nconst result = await validateEmail('user@example.com');\nconsole.log(result); // { isValid: true, isDisposable: false, score: 95, ... }\n```\n\n### Cloud API Service\nFor production applications, use the managed email validation service at [email-check.app](https://email-check.app):\n\n```javascript\nconst response = await fetch('https://api.email-check.app/validate', {\n  method: 'POST',\n  headers: {\n    'Content-Type': 'application/json',\n    'Authorization': 'Bearer YOUR_API_KEY'\n  },\n  body: JSON.stringify({ email: 'user@example.com' })\n});\n\nconst result = await response.json();\n```\n\n### Express.js Middleware (Manual Implementation)\n```javascript\nconst express = require('express');\nconst disposableDomains = require('./disposable-email-providers.json');\n\nconst app = express();\n\n// Middleware to block disposable emails\napp.use((req, res, next) => {\n  if (req.body.email) {\n    const domain = req.body.email.split('@')[1]?.toLowerCase();\n    if (disposableDomains.includes(domain)) {\n      return res.status(400).json({ error: 'Disposable email addresses are not allowed' });\n    }\n  }\n  next();\n});\n\napp.post('/register', (req, res) => {\n  // Registration logic here\n  res.json({ success: true });\n});\n```\n\n### Laravel Validation Rule\n```php\n<?php\n\nnamespace App\\Rules;\n\nuse Closure;\nuse Illuminate\\Contracts\\Validation\\ValidationRule;\n\nclass NotDisposableEmail implements ValidationRule\n{\n    public function validate(string $attribute, mixed $value, Closure $fail): void\n    {\n        $disposableDomains = json_decode(file_get_contents(storage_path('app/disposable-email-providers.json')), true);\n        $domain = strtolower(substr(strrchr($value, '@'), 1));\n\n        if (in_array($domain, $disposableDomains)) {\n            $fail('Disposable email addresses are not allowed.');\n        }\n    }\n}\n```\n\n## 🛠️ Maintenance\n\nThe list is regularly updated through automated processes:\n\n- **Deduplication**: Merge and remove duplicates from multiple sources\n- **Validation**: Verify domain accessibility and functionality\n- **Sorting**: Maintain organized, searchable lists\n- **Regular Updates**: Weekly/monthly updates with new providers\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n### How to Contribute\n\n1. Fork this repository\n2. Create a feature branch (`git checkout -b feature/new-providers`)\n3. Add your changes to the json file\n4. Commit your changes (`git commit -m 'Add new disposable email providers'`)\n5. Push to the branch (`git push origin feature/new-providers`)\n6. Open a Pull Request\n\n## ⚠️ Important Notes\n\n- **Regular Updates**: Disposable email providers appear frequently. Regular updates are recommended\n- **False Positives**: Some legitimate services might be flagged. Consider implementing an allowlist\n- **Performance**: For high-traffic applications, consider loading the data into memory or using a database\n- **Legal Compliance**: Ensure compliance with local regulations regarding email validation\n\n## 🔍 Related Projects\n\n### Cloud Solutions\n- [email-validator-js](https://github.com/email-check-app/email-validator-js/) - **Complete email validation library** with disposable email detection, syntax validation, and deliverability checks\n- [email-check.app](https://email-check.app) - **Managed cloud API** for email validation with high performance and reliability\n\n## 📞 Support\n\nFor questions, issues, or suggestions:\n\n- 🐛 [Report Issues](https://github.com/email-check-app/disposable-email-providers/issues)\n- 💬 [Discussions](https://github.com/email-check-app/disposable-email-providers/discussions)\n- 📧 [Maintainer: EMAIL-CHECK.APP](https://email-check.app)\n- 🌐 [Email Validator Service](https://email-check.app) - For production email validation needs\n\n---\n\n**⭐ If this project helps you, consider giving it a star!**\n","readmeFilename":"README.md","_rev":"1-62a8dc4f5e73ba7598ce28b60c9f1248"}