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.

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.