# ThrowawayMail

> Free disposable email service. Create temporary mailboxes that expire in 10 minutes. No signup required.

ThrowawayMail provides anonymous temporary email addresses for testing, signups, and privacy. Mailboxes auto-expire after 10 minutes. All data is permanently deleted.

## API Documentation

- [OpenAPI Spec](http://throwawaymail.app/api/docs): Interactive Swagger documentation for the JSON API
- [ReDoc](http://throwawaymail.app/api/redoc): Alternative API documentation

## API Endpoints

- [Create Mailbox](http://throwawaymail.app/api/mailboxes): `POST /api/mailboxes` -- creates a new temporary mailbox
- [Get Mailbox](http://throwawaymail.app/api/mailboxes/{mailbox_id}): `GET /api/mailboxes/{mailbox_id}` -- get mailbox details and messages
- [List Messages](http://throwawaymail.app/api/mailboxes/{mailbox_id}/messages): `GET /api/mailboxes/{mailbox_id}/messages` -- list messages in a mailbox
- [Get Message](http://throwawaymail.app/api/mailboxes/{mailbox_id}/messages/{message_id}): `GET /api/mailboxes/{mailbox_id}/messages/{message_id}` -- read a specific message
- [Delete Mailbox](http://throwawaymail.app/api/mailboxes/{mailbox_id}): `DELETE /api/mailboxes/{mailbox_id}` -- delete a mailbox and all its messages
- [WebSocket](http://throwawaymail.app/api/ws/{mailbox_id}): `WS /api/ws/{mailbox_id}` -- real-time new-mail notifications

## Optional

- [How It Works](http://throwawaymail.app/how-it-works): Explanation of the service
- [Privacy Policy](http://throwawaymail.app/privacy): Privacy policy