Temporary disposable email API

Attention! Our API is moved to a new advanced API platform ⇒ Click here for details

This API purpose is to automate QA tasks of the registration process and help to independent developers to create own apps and services that require temporary email functionality.

Note: For many years we have provided completely free and unrestricted access to our API, but as a free service and unfair use of some users - we can’t do it anymore. Please contact us for any further questions.

How it works:

Generate email address by using our domain names.
Sign up on sites that require confirmation by mail.
The site sends email to the address you specify.
Message comes to our SMTP server, processed and added to the database.
You make a request to the API with md5 hash of mail address.
You get a list of emails.

Note: You can generate absolutely any email address without API notification

Usage:

Request address:

https://privatix-temp-mail-v1.p.rapidapi.com/request/mail/id/md5/

Where md5 email address hash

Example:

To check and get a list of emails for a mailbox demo@example.com:

https://privatix-temp-mail-v1.p.rapidapi.com/request/mail/id/7c4ff521986b4ff8d29440beec01972d/

One message:

https://privatix-temp-mail-v1.p.rapidapi.com/request/one_mail/id/md5/

Where md5 unique message identifier assigned by the system.

Source message:

https://privatix-temp-mail-v1.p.rapidapi.com/request/source/id/md5/

Where md5 unique message identifier assigned by the system.

Message attachments:

https://privatix-temp-mail-v1.p.rapidapi.com/request/atchmnts/id/md5/

Where md5 unique message identifier assigned by the system.
Content response field encoded in base64 RFC 4648.

One attachment:

https://privatix-temp-mail-v1.p.rapidapi.com/request/one_attachment/id/md5/atId/

Where md5 unique message identifier assigned by the system. atId - attachment id in attachments list.
Content response field encoded in base64 RFC 4648.

Message attachments (legacy):

https://privatix-temp-mail-v1.p.rapidapi.com/request/attachments/id/md5/

Where md5 unique message identifier assigned by the system.

Delete message:

https://privatix-temp-mail-v1.p.rapidapi.com/request/delete/id/md5/

Where md5 unique message identifier assigned by the system.

Domains list:

To generate email addresses by using a list of domains obtained through API:

https://privatix-temp-mail-v1.p.rapidapi.com/request/domains/

Response parameters:

API firsly returns an HTTP header

Name	Description
200	Messages received (a list of all them)
404	Message (attachment) not found by id!

Response format parameters:

API supports the output format of the responses, it is enough to indicate the end of the query:

Format	Request
XML	/format/xml/
JSON	/format/json/

Example:

To check and get a list of emails for a mailbox demo@example.com in JSON format:

https://privatix-temp-mail-v1.p.rapidapi.com/request/mail/id/7c4ff521986b4ff8d29440beec01972d/format/json/

Response parameters:

Name	Description
mail_unique_id	Unique identifier assigned by the system.
mail_id	Unique identifier of the message in md5 hash assigned by the system.
mail_address_id	md5 email address hash
mail_from	Sender
mail_subject	Subject
mail_preview	Preview
mail_text_only	Message in text or html format (main)
mail_text	Message only in text format
mail_html	Message only in html format