Mailinator

Mailinator API Documentation


Contact Us:    support@manybrain.com

Note: API access is provided for paid accounts only. API use is intended to be a tool to test internal email systems. Abuse of 3rd-party websites using Mailinator is expressly prohibited and may result in account suspension or ban.

The API can access all emails within the public Mailinator system (i.e. emails to @mailinator.com). In addition, the API can access emails in your private domain (if configured)

Note that any email passing through the public Mailinator system, even briefly, should be considered fully in the public view. Mailinator can NOT provide privacy in the public Mailinator system. Don't expect privacy at any level.

Access to the API (and emails in general) are subject to the rate-limits for your subscription plan.

Language Specific Libraries

These libraries are maintained by third-parties.
Mailinator/Manybrain does not guarantee usability, safety, or correctness of these libraries. Use at your own risk.

Java https://github.com/AdamBoulton/jMailinator
Ruby https://github.com/ainformatico/mailinator
Python https://pypi.python.org/pypi/py-mailinator
PHP https://github.com/thepieterdc/mailinator_php
PHP https://github.com/jrmadsen67/MahanaMailinatorAPI
NodeJs https://www.npmjs.org/package/mailinator-api

API

The REST API can be accessed via GET or POST requests and all requests must include the users's API-access-token found on your account settings pane. (Paid users - click the "Settings" button in your Saved Messages view)

Specific examples of using the API are presented below under each individual command. Results are return as JSON with http return content type of 'application/json'.
All API calls should be directed to:

https://api.mailinator.com/
Inbox Access API call:
https://api.mailinator.com/api/inbox?...


Query Parameter Example Default Description
token /api/inbox?token=... none REQUIRED
For all api calls. You can find/change your access token on your account settings pane.
to /api/inbox?to=bobtest See description OPTIONAL
Usage 1: Specify a inbox name to fetch a public inbox.
Usage 2: Do not specify this parameter to fetch all emails in your 'saved messages' folder.
private_domain /api/inbox?private_domain=true false OPTIONAL
Query your private domain repository instead of the public repository. (You must setup your Private Domain within the settings first)

Full Example:
curl "https://api.mailinator.com/api/inbox?to=bob&token=..."


Individual Email Access

Once you have the email id's from a given inbox query, you can retrieve the full email.

Email Access API call:
http://api.mailinator.com/api/email?...
Query Parameter Example Default Description
token /api/email?token=... none REQUIRED
for all api calls. You can find/change your access token on your account settings pane.
id /api/email?id=1373143878-0-test22 * REQUIRED
Specific email id
private_domain /api/email?private_domain=true false OPTIONAL
Query your private domain repository instead of the public repository. (You must setup your Private Domain within the settings first)

Full Example:
curl "https://api.mailinator.com/api/email?id=1373143878-0-test22&token=..."





Delete Email

Once you have the email id's from a given inbox query, you can also delete the email.

Email Access API call:
http://api.mailinator.com/api/delete?...
Query Parameter Example Default Description
token /api/delete?token=... none REQUIRED
for all api calls. You can find/change your access token on your account settings pane.
id /api/delete?id=1373143878-0-test22 * REQUIRED
Specific email id
private_domain /api/delete?private_domain=true false OPTIONAL
Query your private domain repository instead of the public repository. (You must setup your Private Domain within the settings first)

Full Example:
curl "https://api.mailinator.com/api/delete?id=1373143878-0-test22&token=..."