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.
}
}