✉ Correo Temporal

API abierta

Crea buzones temporales y lee correos con una API HTTP sencilla, ideal para pruebas automatizadas y verificación de registros. Todos los endpoints devuelven JSON.

Autenticación

Al crear un buzón se devuelve un token. Envíalo en las siguientes solicitudes:

Authorization: Bearer <token>

Límites de uso

Sin clave de API, cada IP puede crear hasta 10 buzones por minuto. Para límites mayores, envía una clave de API al crear buzones:

X-API-Key: tm_xxxxxxxxxxxxxxxx

Endpoints

MétodoRutaDescripción
GET/api/domainsLista de dominios disponibles
POST/api/mailboxCrear un buzón. Cuerpo vacío para una dirección aleatoria, o {"local":"abc","domain":"…"} para una personalizada
GET/api/mailboxInformación del buzón actual
DELETE/api/mailboxEliminar el buzón y todos sus correos
GET/api/messagesListar la bandeja (últimos 100)
GET/api/messages/{id}Obtener un correo (cuerpo y adjuntos)
DELETE/api/messages/{id}Eliminar un correo
GET/api/messages/{id}/rawDescargar el .eml original
GET/api/attachments/{id}Descargar un adjunto
GET/api/eventsFlujo de eventos SSE, envía event: mail al llegar correos nuevos

Ejemplos

# 1. Crear un buzón. Cuerpo vacío para una dirección aleatoria, o {"local":"abc","domain":"…"} para una personalizada
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
  -H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}

# 2. Listar la bandeja (últimos 100)
curl -s https://www.temp-mail.cc/api/messages \
  -H 'Authorization: Bearer <token>'

# 3. Obtener un correo (cuerpo y adjuntos)
curl -s https://www.temp-mail.cc/api/messages/123 \
  -H 'Authorization: Bearer <token>'
# Python
import requests, time
base = "https://www.temp-mail.cc"
mb = requests.post(f"{base}/api/mailbox", json={}).json()
headers = {"Authorization": f"Bearer {mb['token']}"}
print(mb["address"])
while True:
    msgs = requests.get(f"{base}/api/messages", headers=headers).json()["messages"]
    if msgs:
        print(requests.get(f"{base}/api/messages/{msgs[0]['id']}", headers=headers).json()["text"])
        break
    time.sleep(3)

Errores

En caso de error se devuelve un estado distinto de 2xx con un cuerpo JSON:

{"error": "rate_limited", "message": "…"}

← Volver al inicio