TempMail API i

Quick start guide for developers.

Base URL

https://geniusgsm.com/tempmail/app/api

Create inbox

POST /inboxes/
{"token":"...","address":"xxxx@tempmail.geniusgsm.com","created_at":"..."}

List messages

GET /inboxes/<token>/messages/

Message detail

GET /inboxes/<token>/messages/<id>/

Latest message

GET /inboxes/<token>/latest/

Add header X-Read-Key if enabled.

Latest OTP

GET /inboxes/<token>/otp/?pattern=\b\d{4,8}\b

Add header X-Read-Key if enabled.

Latest message by address

GET /address/latest/?address=you@example.com

Add header X-Read-Key if enabled.

import requests

base_url = "https://geniusgsm.com/tempmail/app/api"

resp = requests.post(f"{base_url}/inboxes/")
resp.raise_for_status()
inbox = resp.json()
token = inbox["token"]
address = inbox["address"]

print("Inbox:", address)

latest = requests.get(f"{base_url}/address/latest/", params={"address": address})
latest.raise_for_status()
print(latest.json())
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class TempMailExample {
  public static void main(String[] args) throws Exception {
    String baseUrl = "https://geniusgsm.com/tempmail/app/api";
    HttpClient client = HttpClient.newHttpClient();

    HttpRequest create = HttpRequest.newBuilder()
        .uri(URI.create(baseUrl + "/inboxes/"))
        .POST(HttpRequest.BodyPublishers.ofString("{}"))
        .header("Content-Type", "application/json")
        .build();

    HttpResponse<String> createResp = client.send(create, HttpResponse.BodyHandlers.ofString());
    System.out.println(createResp.body());

    // Parse token/address from JSON response in your code.
  }
}