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)

Basic usage:

All request should be send via HTTP GET to this endpoint: https://www.1secmail.com/api/v1/ Response is always in JSON.

Generating random email addresses:

This is NOT required. You can use any email address with our domains without generating it before.
Just think your username@our_domains and use it anywhere. Our server are always ready to receive message for any email address. This function just generate random 6-12 character username and add to it one of our latest domains. You can generate any numer of emails at once https://www.1secmail.com/api/v1/?action=genRandomMailbox&count=10

HTTP GET parameters:

Param name	Value
action	genRandomMailbox
count	10 (optional)

Sample output: [ "514adm2s0c@wwjmp.com", "9q6fv8wkwr4@wwjmp.com", "xi9pw5ry@1secmail.com", "xpni3u25w@1secmail.net", "pkbds55jep@1secmail.com", "jeil65xzv8@1secmail.org", "cg89o9i0thml@1secmail.net", "0tw2rcoc3id@1secmail.org", "bdnlnm@1secmail.org", "p8axfdpf65@wwjmp.com" ]

Response fields:

array

Array with email addresses

Getting list of active domains:

This function generate list of currently active domains on which our system is handling incoming emails at the moment https://www.1secmail.com/api/v1/?action=getDomainList

HTTP GET parameters:

Param name	Value
action	getDomainList

Sample output: [ "1secmail.com", "1secmail.org", "1secmail.net", "wwjmp.com", "esiix.com", "xojxe.com", "yoggm.com" ]

Response fields:

array

Array with domains

Checking your mailbox:

To check and get a list of emails for a mailbox demo@1secmail.com: https://www.1secmail.com/api/v1/?action=getMessages&login=demo&domain=1secmail.com

HTTP GET parameters:

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

Sample output: [{ "id": 639, "from": "someone@example.com", "subject": "Some subject", "date": "2018-06-08 14:33:55" }, { "id": 640, "from": "someoneelse@example.com", "subject": "Other subject", "date": "2018-06-08 14:40:55" }]

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: https://www.1secmail.com/api/v1/?action=readMessage&login=demo&domain=1secmail.com&id=639

HTTP GET parameters:

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

Sample output: { "id": 639, "from": "someone@example.com", "subject": "Some subject", "date": "2018-06-08 14:33:55", "attachments": [{ "filename": "iometer.pdf", "contentType": "application\/pdf", "size": 47412 }], "body": "Some message body\n\n", "textBody": "Some message body\n\n", "htmlBody": "" }

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: https://www.1secmail.com/api/v1/?action=download&login=demo&domain=1secmail.com&id=639&file=iometer.pdf

HTTP GET parameters:

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