Gamers Mail API

https://gamersmail.com/api/v1

curl https://gamersmail.com/api/v1/inbox \
 -H "X-API-Key: gm_live_YOUR_KEY_HERE" \
 -H "X-API-Token: gmt_live_YOUR_TOKEN_HERE"

import os
import re
import requests

BASE = "https://gamersmail.com/api/v1"
HEADERS = {
    "X-API-Key": os.environ["GAMERMAIL_API_KEY"],
    "X-API-Token": os.environ["GAMERMAIL_API_TOKEN"],
    "Content-Type": "application/json",
}

def create_temp_email():
    """Create a disposable inbox. Username is optional, and auto-generated if omitted."""
    r = requests.post(f"{BASE}/accounts", json={}, headers=HEADERS, timeout=30)
    r.raise_for_status()
    data = r.json()
    print(f"Created: {data['email']}")
    return data["id"], data["email"]

def wait_for_email(account_id, subject_contains="", from_contains="", timeout=90):
    """Server-side poll that waits until a matching email arrives."""
    params = {
        "timeout": timeout,
        "interval": 3,
        "subjectContains": subject_contains,
        "fromContains": from_contains,
    }
    r = requests.get(
        f"{BASE}/accounts/{account_id}/wait-for-email",
        headers=HEADERS,
        params=params,
        timeout=timeout + 15,
    )
    if r.status_code == 408:
        return None
    r.raise_for_status()
    return r.json()["email"]

def extract_verification_code(text):
    """Pull a 4-8 digit OTP from email subject/body."""
    match = re.search(r"\b(\d{4,8})\b", text)
    return match.group(1) if match else None

def read_inbox(account_id):
    r = requests.get(f"{BASE}/accounts/{account_id}/inbox", headers=HEADERS, timeout=30)
    r.raise_for_status()
    return r.json()["emails"]

def delete_account(account_id):
    requests.delete(f"{BASE}/accounts/{account_id}", headers=HEADERS, timeout=30)

# --- Example: sign-up automation ---
account_id, email = create_temp_email()
print(f"Use this email on the target site: {email}")

# Option A: server waits for you (recommended)
msg = wait_for_email(account_id, subject_contains="verify", timeout=120)
if msg:
    code = extract_verification_code(msg["subject"] + " " + msg.get("body", ""))
    print(f"Verification code: {code}")
else:
    # Option B: manual poll
    for mail in read_inbox(account_id):
        code = extract_verification_code(mail["subject"] + " " + mail.get("body", ""))
        if code:
            print(f"Verification code: {code}")
            break

delete_account(account_id)
print("Done. Account removed.")

{
 "error": "Unauthorized",
 "message": "Missing X-API-Key header"
}