# Testmail — Free Disposable Temporary Email & Developer API

> Testmail (https://tempmail.codaipro.com) provides instant, anonymous temporary disposable email addresses with real-time Server-Sent Events (SSE) streaming, 10-minute privacy auto-purging, and a free, unauthenticated REST API for software testing, automated QA, and trial registrations.

## Core Features
- Instant Disposable Addresses: Format `{namespace}.{tag}@inbox.testmail.app`.
- Real-Time Live Streaming: Receive incoming emails instantly over Server-Sent Events (SSE) without manual polling.
- Privacy Auto-Purge: Received emails automatically expire from the public web interface after 10 minutes.
- Deliverability & Anti-Spam Inspection: Built-in SpamAssassin scoring with rule-by-rule breakdowns.
- Link & Token Extraction: Automated parsing and extraction of verification links, OTP tokens, and activation URLs.
- Free & Open Developer API: 100% free with open CORS (`*`). No signups, API keys, or credit cards required.

## API Quickstart (cURL)

### 1. Generate an Address
```bash
curl -X POST "https://api-tempmail.codaipro.com/api/emails/generate?tag=qa-trial" \
  -H "Content-Type: application/json"
# Returns: {"email":"demo.qa-trial@inbox.testmail.app","tag":"qa-trial","namespace":"demo"}
```

### 2. Poll or List Emails
```bash
curl "https://api-tempmail.codaipro.com/api/emails/?tag=qa-trial&limit=10"
```

### 3. Subscribe to Real-Time SSE Stream
```bash
curl -N "https://api-tempmail.codaipro.com/api/emails/stream"
```

### 4. Extract Links from an Email
```bash
curl "https://api-tempmail.codaipro.com/api/emails/{email_id}/links"
```

### 5. Download RFC 822 Raw Email (.eml)
```bash
curl -OJ "https://api-tempmail.codaipro.com/api/emails/{email_id}/download"
```

## Endpoints Index
- `POST /api/emails/generate` - Generate disposable `{namespace}.{tag}@inbox.testmail.app` address
- `GET /api/emails/` - List/search emails with filters (`tag`, `from_contains`, `subject_contains`, `has_attachments`, `retention_minutes`, `limit`, `offset`)
- `GET /api/emails/{id}` - Fetch complete email details (HTML, plain text, headers, spam report, attachments)
- `GET /api/emails/{id}/links` - Extract unique verification/confirmation URLs and anchor texts
- `GET /api/emails/{id}/download` - Stream raw RFC 822 `.eml` file download
- `GET /api/emails/attachments/{id}/{filename}` - Stream attachment download securely
- `GET /api/emails/stream` - Server-Sent Events stream for instant incoming email delivery
- `GET /api/tags` - List unique tags with email counts
- `GET /api/metrics` - Real-time gateway telemetry, consuming domains, and client analytics
- `GET /health` - Service health, credentials status, and upstream reachability
- `GET /ping` - Keep-alive latency ping endpoint

## Documentation & Full Reference
- Full LLM Manual: https://tempmail.codaipro.com/llms-full.txt
- Interactive API Reference: https://tempmail.codaipro.com/api-reference
- Developer Documentation & Self-Hosting: https://tempmail.codaipro.com/docs
- Open Source Repository: https://github.com/Luckyyaduvanshiofficial/testmail
- OpenAPI Swagger Spec: https://api-tempmail.codaipro.com/docs

## Competitor Comparisons & Developer Guides
- Master 2026 Comparison Benchmark: https://tempmail.codaipro.com/compare
- Testmail vs Temp-Mail.org: https://tempmail.codaipro.com/compare/temp-mail-org
- Testmail vs Temp-Mail.io: https://tempmail.codaipro.com/compare/temp-mail-io
- Testmail vs Tempail: https://tempmail.codaipro.com/compare/tempail
- Top 5 Best Temp Mail in 2026: https://tempmail.codaipro.com/best-temp-mail
- Temp Mail for Testing (Playwright & Cypress): https://tempmail.codaipro.com/temp-mail-for-testing
- Free Temp Mail API Guide: https://tempmail.codaipro.com/temp-mail-api
- 10 Minute Mail Online Guide: https://tempmail.codaipro.com/10-minute-mail
- Best Disposable Email Service for Engineers: https://tempmail.codaipro.com/best-disposable-email