npm package: 10minmail
Description: 10 Minute Email Service: A Free and Secure Solution for Your Temporary Email Needs
Author: 10Minute-Email
Latest version: 1.0.2

# 10 Minute Email Service: A Free and Secure Solution for Your Temporary Email Needs

Are you tired of spam, phishing, and unwanted emails? Do you want to sign up for websites or services without revealing your personal email address? Do you want to keep your online identity and privacy safe? If you answered yes to any of these questions, then you need a 10 minute email service. 

![10min mail screen](https://10minute-email.com/images/10min-soc.png)

A **10 minute email service** is a free online service that gives you a temporary email address that you can use for a specific purpose and then forget. You can use it to register for websites, receive confirmation emails, access content, or communicate with someone anonymously. The email address is valid for 10 minutes and then disappears. Any emails sent to it are no longer available. This way, you can avoid spam, protect your privacy, and stay secure online. 

A [10 minute email service](https://10minute-email.com/) is easy to use, reliable, and doesn't require any signup. All you need to do is visit the website and get a temporary email address. You can then use it as you wish and discard it. It is the ultimate solution for your temporary email needs.

# 10 Minute Email Service API

The 10 Minute Email Service API allows you to create and use temporary email addresses for various purposes. You can use the API to generate disposable email addresses, check the inbox of the email addresses, and delete the email addresses when they expire.

## Getting Started

To use the API, you need to make HTTP requests to the base URL: `https://api.10minutemail.com/`

The API supports JSON format for both requests and responses.

The API does not require any authentication or API keys.

## Endpoints

The API has three main endpoints:

- /domains: This endpoint returns a list of available domain names that you can use to create temporary email addresses.
- /addresses: This endpoint allows you to create, retrieve, and delete temporary email addresses.
- /messages: This endpoint allows you to retrieve and delete messages from the inbox of a temporary email address.

## Examples

Here are some examples of how to use the API with curl commands:

### Get a list of available domains

`curl https://api.10minutemail.com/domains`

The response will be an array of domain names, such as:

```json
[
  "@10minutemail.com",
  "@tempmail.com",
  "@fakemail.net"
]
```

### Create a temporary email address

`curl -X POST https://api.10minutemail.com/addresses -d '{"username":"test","domain":"@10minutemail.com"}'`

The request body should contain a JSON object with two properties: username and domain. The username should be a string of alphanumeric characters, and the domain should be one of the available domains from the /domains endpoint.

The response will be a JSON object with the following properties:

- address: The temporary email address that was created.
- expires_at: The timestamp when the email address will expire.
- created_at: The timestamp when the email address was created.

For example:

```json
{
  "address": "test@10minutemail.com",
  "expires_at": "2023-05-06T19:13:57Z",
  "created_at": "2023-05-06T19:03:57Z"
}
```

### Get a temporary email address

`curl https://api.10minute-email.com/addresses/test@10minutemail.com`

The request should include the temporary email address as a path parameter.

The response will be the same as the one for creating a temporary email address, if the email address exists and has not expired.

### Delete a temporary email address

`curl -X DELETE https://api.10minute-email.com/addresses/test@10minutemail.com`

The request should include the temporary email address as a path parameter.

The response will be an empty JSON object if the email address was deleted successfully.

### Get messages from a temporary email address

`curl https://api.10minute-email.com/messages/test@10minutemail.com`

The request should include the temporary email address as a path parameter.

The response will be an array of JSON objects, each representing a message in the inbox of the email address. Each message object will have the following properties:

- id: A unique identifier for the message.
- from: The sender of the message.
- subject: The subject of the message.
- body: The content of the message.
- received_at: The timestamp when the message was received.

For example:

```json
[
  {
    "id": "1234567890",
    "from": "sender@example.com",
    "subject": "Hello",
    "body": "This is a test message.",
    "received_at": "2023-05-06T19:05:57Z"
  },
  {
    "id": "0987654321",
    "from": "noreply@website.com",
    "subject": "Confirmation",
    "body": "Please click this link to confirm your account.",
    "received_at": "2023-05-06T19:07:57Z"
  }
]
```

### Delete a message from a temporary email address

`curl -X DELETE https://api.10minute-email.com/messages/1234567890`

The request should include the message id as a path parameter.

The response will be an empty JSON object if the message was deleted successfully.


♡ [10minute-email](https://10minute-email.com)

## Mirrors
[Npmmirror](https://npmmirror.com/package/10minmail) , [Yarn](https://yarnpkg.com/package/10minmail)