What is a TempMailTo temporary email address?

A temporary email address, like those provided by TempMailTo, is a disposable, short-term email that allows you to receive messages without exposing your personal email. It's perfect for signing up for websites or services without worrying about spam.

How long does a temporary email address last?

The lifespan of a temporary email address varies. Typically, it lasts between 10 minutes to a few hours, but some services allow you to extend its duration.

temp-mail-developers | Temp Mail To

API Overview & Authentication

Welcome to the developer API for tempmailto.com. This API enables you to programmatically generate random temporary email addresses, customize address configurations, list messages, and manage dynamic disposal routines directly from your own software applications, QA scripts, and automation workflows.

Base URL

https://tempmailto.com/api

Authentication

Authentication is handled by passing your global API key directly in the request path parameters. You can locate or configure this API key in your administrator dashboard settings panel.

Authentication Parameter	Type	Location	Value
apiKey	string	URL Path segment	`MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7`

GET Get Active Domains

Fetch list of all allowed domain names configured on the platform that can be used to generate temporary mailboxes.

GET https://tempmailto.com/api/domains/{apiKey}/{type}

Path Parameters

Parameter	Type	Status	Description
apiKey	string	Required	Your secret API authorization key.
type	string	Required	Domain filter type. Accepted values: all, free, premium.

curl -X GET "https://tempmailto.com/api/domains/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/all"

const axios = require('axios');

axios.get('https://tempmailto.com/api/domains/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/all')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

import requests

url = 'https://tempmailto.com/api/domains/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/all'
response = requests.get(url)
print(response.json())

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://tempmailto.com/api/domains/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/all');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

Example Response

{
  "status": true,
  "data": {
    "domains": [
      {
        "domain": "tempmailto.com",
        "type": "Free"
      }
    ]
  }
}

POST Generate New Email

Instantly generate and register a new random temporary email address address.

POST https://tempmailto.com/api/emails/{apiKey}

Path Parameters

Parameter	Type	Status	Description
apiKey	string	Required	Your secret API authorization key.

curl -X POST "https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7"

const axios = require('axios');

axios.post('https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

import requests

url = 'https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7'
response = requests.post(url)
print(response.json())

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

Example Response

{
  "status": true,
  "data": {
    "id": 142,
    "email": "[email protected]",
    "domain": "tempmailto.com",
    "ip": "127.0.0.1",
    "fingerprint": "f38b25...",
    "expire_at": "2026-06-20 13:45:00",
    "created_at": "2026-06-20 13:35:00",
    "email_token": "eyJpdiI..."
  }
}

POST Customize Email Address

Transition an existing email to a customized address with a specific username and active domain.

POST https://tempmailto.com/api/emails/{apiKey}/{email}/{username}/{domain}

Path Parameters

Parameter	Type	Status	Description
apiKey	string	Required	Your secret API authorization key.
email	string	Required	The current temporary email address you want to change.
username	string	Required	The customized alias/username prefix for the new address.
domain	string	Required	One of the active domain names fetched from the active domains endpoint.

curl -X POST "https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]/john_doe/tempmailto.com"

const axios = require('axios');

axios.post('https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]/john_doe/tempmailto.com')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

import requests

url = 'https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]/john_doe/tempmailto.com'
response = requests.post(url)
print(response.json())

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]/john_doe/tempmailto.com');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

Example Response

{
  "status": true,
  "data": {
    "id": 143,
    "email": "[email protected]",
    "domain": "tempmailto.com",
    "ip": "127.0.0.1",
    "fingerprint": "f38b25...",
    "expire_at": "2026-06-20 13:45:00",
    "created_at": "2026-06-20 13:35:00"
  }
}

POST Delete Temporary Email

Instantly release and expire a temporary email address to delete all cached inbox data.

POST https://tempmailto.com/api/emails/{apiKey}/{email}

Path Parameters

Parameter	Type	Status	Description
apiKey	string	Required	Your secret API authorization key.
email	string	Required	The active temporary email address to be removed.

curl -X POST "https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]"

const axios = require('axios');

axios.post('https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

import requests

url = 'https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]'
response = requests.post(url)
print(response.json())

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://tempmailto.com/api/emails/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

Example Response

{
  "status": true,
  "message": "Email has been successfully deleted."
}

GET Get Inbox Messages

Retrieve all message metadata and message summaries received inside the inbox of the specified temporary address.

GET https://tempmailto.com/api/messages/{apiKey}/{email}

Path Parameters

Parameter	Type	Status	Description
apiKey	string	Required	Your secret API authorization key.
email	string	Required	The temporary email address to fetch the messages for.

curl -X GET "https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]"

const axios = require('axios');

axios.get('https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

import requests

url = 'https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]'
response = requests.get(url)
print(response.json())

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/[email protected]');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

Example Response

{
  "status": true,
  "data": [
    {
      "id": "M2ZkMXQ1",
      "subject": "Verify your Account",
      "from": "Service Provider",
      "from_email": "[email protected]",
      "receivedAt": "2026-06-20 13:40:00",
      "is_seen": false,
      "html": true
    }
  ]
}

GET Get Message Detail

Retrieve the full HTML/plain text body content, sender fields, headers, and attachments list of a specific message ID.

GET https://tempmailto.com/api/messages/{apiKey}/message/{messageId}

Path Parameters

Parameter	Type	Status	Description
apiKey	string	Required	Your secret API authorization key.
messageId	string	Required	The unique identifier key of the message.

curl -X GET "https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/message/M2ZkMXQ1"

const axios = require('axios');

axios.get('https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/message/M2ZkMXQ1')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

import requests

url = 'https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/message/M2ZkMXQ1'
response = requests.get(url)
print(response.json())

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/message/M2ZkMXQ1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

Example Response

{
  "status": true,
  "data": {
    "id": "M2ZkMXQ1",
    "subject": "Verify your Account",
    "from": "Service Provider",
    "from_email": "[email protected]",
    "to": "[email protected]",
    "receivedAt": "2026-06-20 13:40:00",
    "is_seen": true,
    "html": true,
    "content": "<p>Hi John, your verification code is <b>857102</b></p>",
    "attachments": []
  }
}

POST Delete Message

Permanently purge and delete a specific message from the temp inbox storage.

POST https://tempmailto.com/api/messages/{apiKey}/message/{messageId}

Path Parameters

Parameter	Type	Status	Description
apiKey	string	Required	Your secret API authorization key.
messageId	string	Required	The unique identifier key of the message to be deleted.

curl -X POST "https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/message/M2ZkMXQ1"

const axios = require('axios');

axios.post('https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/message/M2ZkMXQ1')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

import requests

url = 'https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/message/M2ZkMXQ1'
response = requests.post(url)
print(response.json())

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://tempmailto.com/api/messages/MONz3isg4e9IZ2dKCy8Ym7QJCUyR4e7/message/M2ZkMXQ1');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

Example Response

{
  "status": true,
  "message": "Message has been successfully deleted."
}

Developer API Reference

Endpoints

API Overview & Authentication

Base URL

Authentication

GET Get Active Domains

Path Parameters

POST Generate New Email

Path Parameters

POST Customize Email Address

Path Parameters

POST Delete Temporary Email

Path Parameters

GET Get Inbox Messages

Path Parameters

GET Get Message Detail

Path Parameters

POST Delete Message

Path Parameters