Temp Mail API

This api was created in order to automate the registration process at the various sites.

Access to the API:

Available completely free of charge and without restriction. Why is it free? We're testing the system load and optimizing code.

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.

Usage:

Request address:

http://api.temp-mail.org/request/mail/id/md5/

Where md5 email address hash

Example:

To check and get a list of emails for a mailbox [email protected]:

http://api.temp-mail.org/request/mail/id/7c4ff521986b4ff8d29440beec01972d/

Source message list:

http://api.temp-mail.org/request/source/id/md5/

Where md5 email address hash

Delete message

http://api.temp-mail.org/request/delete/id/md5/

Where md5 unique identifier assigned by the system.

Domains list:

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

http://api.temp-mail.org/request/domains/

Response parameters:

API firsly returns an HTTP header

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

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/
JSONP /format/jsonp/
PHP /format/php/
HTML /format/html/

Example:

To check and get a list of emails for a mailbox [email protected] in JSON format:

http://api.temp-mail.org/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

Examples of integration:

Questions and suggestions:

If you have any questions or suggestions, please contact us via the feedback form