API Documentation

Getting Started

Our API allows you to programmatically create temporary email addresses and retrieve messages. All requests are made over HTTPS for security.

Base URL: https://api.tempmail101.com/v1

Authentication

API access requires an API key. Include your key in the Authorization header with every request.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

API Endpoints

Create Temporary Email

POST /emails

Creates a new temporary email address with optional custom prefix.

{
  "domain": "tempmail101.com",
  "prefix": "custom-prefix" // optional
}

Get Messages

GET /emails/{email}/messages

Retrieves all messages for a specific email address.

Delete Email

DELETE /emails/{email}

Deletes a temporary email address and all associated messages.

Code Examples

JavaScript

// Create a temporary email
const response = await fetch('https://api.tempmail101.com/v1/emails', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain: 'tempmail101.com'
  })
});

const data = await response.json();
console.log(data.email); // temporary email address

Python

import requests

# Create a temporary email
response = requests.post(
    'https://api.tempmail101.com/v1/emails',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={'domain': 'tempmail101.com'}
)

data = response.json()
print(data['email'])  # temporary email address

Rate Limits

API requests are limited to ensure fair usage and service stability for all users.

Free tier: 100 requests per hour
Premium tier: 1,000 requests per hour
Enterprise: Custom limits available

Navigation