API Documentation

Integrate with our API to create and manage temporary email addresses programmatically.

Get Active Domains

Retrieve a list of active domains available for generating temporary email addresses.

HTTP

cURL

JavaScript

Python

POST /api/v2/email/domains

POST /api/v2/email/domains HTTP/1.1
Host: https://tempmail.tzsmm.com
Content-Type: application/json

{
    "api_key": "your_api_key"
}

curl -X POST "https://tempmail.tzsmm.com/api/v2/email/domains" \
     -H "Content-Type: application/json" \
     -d '{"api_key": "your_api_key"}'

const response = await fetch('https://tempmail.tzsmm.com/api/v2/email/domains', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    api_key: 'your_api_key'
  })
});
const data = await response.json();
console.log(data);

import requests

url = "https://tempmail.tzsmm.com/api/v2/email/domains"
headers = {
    "Content-Type": "application/json"
}
data = {
    "api_key": "your_api_key"
}

response = requests.get(url, headers=headers, json=data)
print(response.json())

Example Response

{
    "status": true,
    "success": {
        "domains": ["tzsmm.top", "tzsmm.com"],
        "total": 2
    }
}

Generate Temporary Email

Create a new temporary email address with a single API call.

HTTP

cURL

JavaScript

Python

POST /api/v2/email/generate

POST /api/v2/email/generate HTTP/1.1
Host: https://tempmail.tzsmm.com
Content-Type: application/json

{
    "api_key": "your_api_key",
    "domain": "tzsmm.top"
}

curl -X POST "https://tempmail.tzsmm.com/api/v2/email/generate" \
     -H "Content-Type: application/json" \
     -d '{"api_key": "your_api_key", "domain": "tzsmm.top"}'

const response = await fetch('https://tempmail.tzsmm.com/api/v2/email/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    api_key: 'your_api_key',
    domain: 'tzsmm.top'
  })
});
const data = await response.json();
console.log(data);

import requests

url = "https://tempmail.tzsmm.com/api/v2/email/generate"
headers = {
    "Content-Type": "application/json"
}
data = {
    "api_key": "your_api_key",
    "domain": "tzsmm.top"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Example Response

{
    "status": true,
    "email": "[email protected]",
    "expires_at": "2025-07-15T14:20:00Z",
    "token": "random_token_32_chars"
}

Fetch Email Inbox

Retrieve all emails for a specific temporary email address using the provided token.

HTTP

cURL

JavaScript

Python

POST /api/v2/email/inbox

POST /api/v2/email/inbox HTTP/1.1
Host: https://tempmail.tzsmm.com
Content-Type: application/json

{
    "api_key": "your_api_key",
    "token": "random_token_32_chars"
}

curl -X POST "https://tempmail.tzsmm.com/api/v2/email/inbox" \
     -H "Content-Type: application/json" \
     -d '{"api_key": "your_api_key", "token": "random_token_32_chars"}'

const response = await fetch('https://tempmail.tzsmm.com/api/v2/email/inbox', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    api_key: 'your_api_key',
    token: 'random_token_32_chars'
  })
});
const data = await response.json();
console.log(data);

import requests

url = "https://tempmail.tzsmm.com/api/v2/email/inbox"
headers = {
    "Content-Type": "application/json"
}
data = {
    "api_key": "your_api_key",
    "token": "random_token_32_chars"
}

response = requests.get(url, headers=headers, json=data)
print(response.json())

Example Response

{
    "status": true,
    "emails": [
        {
            "email_id": 1,
            "uid": "123",
            "from": "[email protected]",
            "subject": "Your verification code",
            "preview": "Your code is 583921...",
            "received_at": "2025-07-15T13:30:45Z",
            "read": false
        }
    ],
    "total": 1
}

Fetch Email Content

Retrieve the full content of a specific email using the email ID and token.

HTTP

cURL

JavaScript

Python

POST /api/v2/email/message

POST /api/v2/email/message HTTP/1.1
Host: https://tempmail.tzsmm.com
Content-Type: application/json

{
    "api_key": "your_api_key",
    "token": "random_token_32_chars",
    "email_id": 1
}

curl -X POST "https://tempmail.tzsmm.com/api/v2/email/message" \
     -H "Content-Type: application/json" \
     -d '{"api_key": "your_api_key", "token": "random_token_32_chars", "email_id": 1}'

const response = await fetch('https://tempmail.tzsmm.com/api/v2/email/message', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    api_key: 'your_api_key',
    token: 'random_token_32_chars',
    email_id: 1
  })
});
const data = await response.json();
console.log(data);

import requests

url = "https://tempmail.tzsmm.com/api/v2/email/message"
headers = {
    "Content-Type": "application/json"
}
data = {
    "api_key": "your_api_key",
    "token": "random_token_32_chars",
    "email_id": 1
}

response = requests.get(url, headers=headers, json=data)
print(response.json())

Example Response

{
    "status": true,
    "id": 1,
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Your verification code",
    "html_content": "Your code is 583921...",
    "text_content": "Your code is 583921...",
    "attachments": [],
    "received_at": "2025-07-15T13:30:45Z"
}

Quick Start Guide

1. Get Your API Key

Generate or copy your unique API key from your account dashboard.

2. Make Your First Request

Use the generate email endpoint to create a temporary email address.

3. Check the Inbox

Fetch emails using the returned token and retrieve email content as needed.

cURL Example

curl -X POST "https://tempmail.tzsmm.com/api/v2/email/generate" \
     -H "Content-Type: application/json" \
     -d '{"api_key":"your_api_key", "domain": "tzsmm.top"}'