# TempMailChecker

> High-performance API to detect disposable and temporary email addresses. One request, one boolean. Sub-5ms response times.

TempMailChecker is a REST API service that helps developers identify and block disposable/temporary email addresses during user registration, checkout, or any email validation flow.

## Quick Start

```bash
curl "https://tempmailchecker.com/check?email=test@mailinator.com" \
  -H "X-API-Key: your_api_key"
```

Response:
```json
{"temp": true}
```

## API Overview

### Base URL
- https://tempmailchecker.com
- (Legacy aliases us.tempmailchecker.com and asia.tempmailchecker.com remain supported and point to the same service.)

### Authentication
Include your API key in the `X-API-Key` header.

### Main Endpoint

**GET /check**

Check if an email is disposable.

Parameters:
- `email` (required): The email address to check

Response:
- `temp: true` - Email is from a disposable/temporary email service
- `temp: false` - Email is from a legitimate email provider

### Usage Endpoint

**GET /usage**

Check your current API usage.

Parameters:
- `key` (required): Your API key

Response (free plan):
```json
{
  "usage_today": 10,
  "limit": 25,
  "reset": "midnight UTC"
}
```

Response (paid plans, monthly quota):
```json
{
  "usage_this_month": 1204,
  "limit": 3000,
  "reset": "2026-08-09"
}
```

## Code Examples

### Python
```python
import requests

def is_disposable(email, api_key):
    response = requests.get(
        "https://tempmailchecker.com/check",
        params={"email": email},
        headers={"X-API-Key": api_key}
    )
    return response.json().get("temp", False)
```

### JavaScript
```javascript
async function isDisposable(email, apiKey) {
  const response = await fetch(
    `https://tempmailchecker.com/check?email=${encodeURIComponent(email)}`,
    { headers: { 'X-API-Key': apiKey } }
  );
  const data = await response.json();
  return data.temp;
}
```

### PHP
```php
function isDisposable($email, $apiKey) {
    $url = "https://tempmailchecker.com/check?email=" . urlencode($email);
    $opts = ["http" => ["header" => "X-API-Key: " . $apiKey]];
    $response = file_get_contents($url, false, stream_context_create($opts));
    return json_decode($response, true)['temp'] ?? false;
}
```

## Pricing

| Plan | Requests | Period | Price |
|------|----------|--------|-------|
| Free | 25 | per day | $0 |
| Starter | 3,000 | per month | $12/mo |
| Growth | 15,000 | per month | $29/mo |
| Scale | 60,000 | per month | $69/mo |
| Enterprise | 250,000+ | custom | Contact us |

## Key Features

- **277,000+ domains** in our disposable email database
- **Sub-5ms response times** at the server
- **One simple endpoint** - no region selection needed
- **Simple REST API** - one endpoint, one boolean response
- **No dependencies** - works with any language or framework
- **Real-time updates** - database continuously updated
- **99.9% uptime** - enterprise-grade reliability

## Common Use Cases

1. **Block fake signups** - Prevent disposable emails during registration
2. **Protect promotions** - Stop coupon/referral abuse
3. **Clean email lists** - Validate existing subscriber lists
4. **Reduce fraud** - Block throwaway accounts in checkout flows
5. **Community protection** - Prevent ban evasion and trolling

## Error Codes

| Code | Meaning |
|------|---------|
| 200 | Success |
| 400 | Bad request (invalid email format) |
| 401 | Unauthorized (missing or invalid API key) |
| 429 | Rate limit exceeded |
| 500 | Server error |

## Rate Limits

- Free tier: 25 requests/day (resets at midnight UTC)
- Paid plans: Monthly limits (reset on billing anniversary)
- 80% usage warning emails sent automatically

## Links

- Agent setup guide (markdown docs): https://tempmailchecker.com/agent-setup
- Documentation: https://tempmailchecker.com/docs
- API Status: https://tempmailchecker.com/status
- Pricing: https://tempmailchecker.com/pricing
- Get API Key: https://tempmailchecker.com/signup
- FAQ: https://tempmailchecker.com/faq
- Code Examples: https://tempmailchecker.com/code-examples
- GitHub: https://github.com/Fushey/tempmailchecker-api

## Contact

- Support: support@tempmailchecker.com
- Report domains: report@tempmailchecker.com
- General: contact@tempmailchecker.com

## About

TempMailChecker was built to solve a simple problem: blocking disposable emails without complex integrations or slow API calls. We focus on speed, accuracy, and developer experience.

Our database is continuously updated through automated scrapers, community reports, and manual verification. New disposable domains are typically added within 24 hours of discovery.

We're GDPR compliant, based in the EU, and committed to privacy. We don't store full email addresses long-term—only domain-level statistics for rate limiting and analytics.