Copy Refresh Delete Random API

API


This API purpose is to help independent developers to automate their work and create own apps and services that require temporary email functionality.

How it works:

  • Generate any 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 login and domain part of email address.
  • You get a list of emails.
  • You make a request to the API with message ID, login and domain part of email address to get message details (body, subject, date, attachments etc)
Note: You can generate any email address using our domain names without API notification - just think your username@our_domains and use it anywhere. Our server are always ready to receive message for any email address.
Attention: For security reason you cannot read messages from addresses: abuse@domain, webmaster@domain, contact@domain, postmaster@domain, hostmaster@domain, admin@domain. All other addresses are free to use.

Basic usage:

All request should be send via HTTP GET to this endpoint: Response is always in JSON.

Checking your mailbox:

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

HTTP GET parameters:

Param name Value
action getMessages
login demo (username)
domain 1secmail.com (domain)

Sample output:

Response fields:

id Message id
from Sender email address
subject Subject
date Receive date

Fetching single message:

Now you can fetch single message with another API call:

HTTP GET parameters:

Param name Value
action readMessage
login demo (username)
domain 1secmail.com (domain)
id 639 (message id)

Sample output:

Response fields:

id Message id
from Sender email address
subject Subject
date Receive date
attachments Attachments list
body Message body (html if exists, text otherwise)
textBody Message body (text)
htmlBody Message body (html)

Attachment download:

To download attachment from message:

HTTP GET parameters:

Param name Value
action readMessage
login demo (username)
domain 1secmail.com (domain)
id 639 (message id)
file iometer.pdf (filename of attachment)