Basics

The baseURL of this project is basically https://mailloop.org. All your request shall go towards this baseURL. For now all Endpoints support GET method, to ensure simplicity and easier CLI/Browser compatibility.

Rate Limiting

We are imposing Rate Limiting. You can call API Endpoints 20 times within 60 seconds. If you call more than 20, your IP will be blocked for 5 minutes. We believe 20 API Calls per IP per Minute should be enough to perform proper tests.

Sender Domain

This service is designed for software testers, not for script kiddies. You can create mailboxes for certain domains. Lets say you test with your new project newproject.com, then you need to mention this as sender domain in order to be able to receive domains from <anything>@newproject.com. This requirement is there to keep script kiddies away from abusing our service as disposable service.

Blocked Domains

we block over 1000 major domains from being Sender Domain, for example amazon.com and many other major websites are blocked because we do not think they want to use our service to make tests. We target mainstream software developers and want to solve their needs rather than being disposable email provider.

API

GET /create

Use this endpoint to generate a new mailbox to receive emails, you need to mention Sender Domain in order being able to create a mailbox. Details

GET /read

Endpoint to read emails from your mailbox.Details