API Documentation

Create and manage temporary email addresses programmatically.

Introduction

The fake.legal API lets you create disposable email addresses and retrieve incoming messages. All endpoints return JSON.

Base URL:

https://fake.legal/api

Authentication

No authentication required. The API is free and open.

Rate Limits & High-Volume Access

Our infrastructure is built for privacy and scale. Standard access is free, but power users can unlock a 10x Performance Boost for heavy automation.

Metric Standard (Free) 🚀 Premium Boost
Pricing € 0.00 € 2.00 (One-time, Lifetime)
API Calls / Hour 135 10,000
Burst Capacity 300 requests 3,000 requests
Refill Rate 30 / second 300 / second
Verification Zero Logs No KYC / Anonymous

Need raw power for your scripts or integrations?

How it works:

After your 2.00 € PayPal transfer, the Unique ID generated for your payment (e.g., USER_A1B2C3) instantly becomes your Premium API Key. Just include it in your HTTP headers to bypass standard limits:

x-api-key: USER_A1B2C3

Create Inbox

GET /api/inbox/new

Creates a new inbox with a randomly generated email address.

Query Parameters

Name Type Description
domain string Optional. One of: fake.legal, imgui.de, pulsewebmenu.de, gooncraft.de

Response

{
  "success": true,
  "address": "[email protected]",
  "expiresIn": "3 minutes"
}

Custom Inbox

POST /api/inbox/custom

Creates an inbox with a custom username.

Request Body

{
  "username": "myname",
  "domain": "fake.legal"
}

Response

{
  "success": true,
  "address": "[email protected]"
}

Get Emails

GET /api/inbox/{address}

Returns all emails for the specified inbox.

Response

{
  "success": true,
  "exists": true,
  "emails": [
    {
      "id": "abc-123",
      "from": "[email protected]",
      "subject": "Your verification code",
      "date": "2026-01-12T12:00:00Z"
    }
  ]
}

Get Email

GET /api/email/{id}

Returns the full content of a single email.

Response

{
  "success": true,
  "email": {
    "id": "abc-123",
    "from": "[email protected]",
    "subject": "Your code",
    "text": "Your code is 123456",
    "html": "<html>...</html>"
  }
}

Stats

GET /api/stats

Returns service statistics and available domains.

Response

{
  "activeInboxes": 42,
  "totalReceived": 12345,
  "domains": ["fake.legal", "imgui.de", ...]
}

Examples

cURL

# Create inbox
curl https://fake.legal/api/inbox/new

# Get emails
curl https://fake.legal/api/inbox/[email protected]

Python

import requests

# Create inbox
r = requests.get("https://fake.legal/api/inbox/new")
email = r.json()["address"]

# Check for emails
r = requests.get(f"https://fake.legal/api/inbox/{email}")
emails = r.json()["emails"]

JavaScript

// Create inbox
const res = await fetch("https://fake.legal/api/inbox/new");
const { address } = await res.json();

// Get emails
const inbox = await fetch(`https://fake.legal/api/inbox/${address}`);
const { emails } = await inbox.json();

Support & High-Volume

Technical issues or custom enterprise requirements? Email [email protected]