Dokumentasi API API Documentation

Referensi REST API untuk akses email sementara secara terprogram. REST API reference for programmatic temporary email access.

Kunci API Aktif Active API Key

Gambaran Umum Overview

Base URL: https://api.tempmailbase.com
Authentication: Sertakan kunci API Anda di setiap permintaan sebagai headerInclude your API key in every request as the X-API-Key header.
Format: Semua respons menggunakan JSON dan encoding UTF-8.All responses are JSON. All requests and responses use UTF-8 encoding.

Endpoint	Batas HarianDaily Limit	Batas BeruntunBurst Limit
`POST /api/v1/mailbox/create`	200 / day	30 / min
`GET /api/v1/mailbox/inbox`	1,000 / day	60 / min
`GET /api/v1/mailbox/wait`	200 / day	10 / min

Titik Akhir (Endpoints) Endpoints

POST /api/v1/mailbox/create

Membuat kotak masuk sementara baru. Alamat berlaku selama 7 hari. Provision a new temporary mailbox. The address is valid for 7 days.

import requests

r = requests.post(
    "https://api.tempmailbase.com/api/v1/mailbox/create",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
data = r.json()
print(data["address"])

const res = await fetch(
  "https://api.tempmailbase.com/api/v1/mailbox/create",
  {
    method: "POST",
    headers: { "X-API-Key": "YOUR_API_KEY" }
  }
);
const { address } = await res.json();

curl -X POST https://api.tempmailbase.com/api/v1/mailbox/create \
  -H "X-API-Key: YOUR_API_KEY"

{
  "address":    "xk7p2mq3ab@kicaumania.web.id",
  "expires_at": "2026-05-04T11:16:12.000Z"
}

GET /api/v1/mailbox/wait

Mengecek email terbaru secara instan. Panggil ulang setiap beberapa detik. Otomatis mengekstrak OTP. Check the latest email instantly. Poll again every few seconds. Automatically extracts OTP.

r = requests.get(
    "https://api.tempmailbase.com/api/v1/mailbox/wait",
    params={"address": address},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
result = r.json()
if result["received"]:
    print("OTP:", result["email"]["otp"])

const res = await fetch(
  `https://api.tempmailbase.com/api/v1/mailbox/wait?address=${address}`,
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();
if (data.received) console.log("OTP:", data.email.otp);

curl "https://api.tempmailbase.com/api/v1/mailbox/wait?address=YOUR_CREATED_MAILBOX@kicaumania.web.id" \
  -H "X-API-Key: YOUR_API_KEY"

GET /api/v1/mailbox/inbox

Mengambil semua email yang ada di dalam kotak masuk. Retrieve all emails in a mailbox.

curl "https://api.tempmailbase.com/api/v1/mailbox/inbox?address=YOUR_CREATED_MAILBOX@kicaumania.web.id" \
  -H "X-API-Key: YOUR_API_KEY"