Claves API Temp Mail para automatizar las pruebas de correo

Listar dominios públicos activos

Devuelve los dominios disponibles para generar direcciones. Esta utilidad pública no requiere clave API ni consume cuota. Se excluyen los dominios privados de GPTMail.

curl -sS "https://cleantempmail.com/api/domains?limit=100"

{
  "success": true,
  "data": {
    "domains": ["domain-one.example", "domain-two.example"],
    "total": 1832,
    "offset": 0,
    "limit": 100
  }
}

Generar una dirección de correo temporal

GET crea una dirección con un prefijo generado y un dominio activo aleatorio. POST permite elegir prefijo, dominio o ambos. La dirección final siempre se devuelve en data.email.

curl -sS \
  -H "X-API-Key: ct-test" \
  "https://cleantempmail.com/api/generate-email"

curl -sS -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"prefix":"qa.user","domain":"your-active-domain.com"}' \
  "https://cleantempmail.com/api/generate-email"

Si el dominio solicitado deja de estar activo, la API devuelve HTTP 409 en lugar de cambiar de dominio sin avisar.

Listar los mensajes de una bandeja

Devuelve hasta los 500 mensajes más recientes de una dirección pública de CleanTempMail. Una bandeja nueva o vacía devuelve emails: [] y count: 0.

curl -sS -G \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://cleantempmail.com/api/emails"

{
  "success": true,
  "data": {
    "emails": [
      {
        "id": "66c123example",
        "email_address": "[email protected]",
        "from_address": "[email protected]",
        "subject": "Your verification code",
        "content": "Your code is 123456",
        "html_content": "<p>Your code is <b>123456</b></p>",
        "has_html": true,
        "attachments": [
          {
            "id": "attachment-id",
            "filename": "receipt.pdf",
            "content_type": "application/pdf",
            "size": 48231
          }
        ],
        "timestamp": 1787702400,
        "raw_size": 51984,
        "created_at": "2026-08-25T12:00:00Z"
      }
    ],
    "count": 1
  },
  "usage": { "daily_limit": 100, "used_today": 2, "remaining_today": 98, "total_limit": 1000, "total_used": 2, "remaining_total": 998 }
}

Obtener un mensaje completo

Usa el id devuelto por /api/emails para obtener el texto/HTML, las cabeceras, las marcas de tiempo y los metadatos de los adjuntos. Los datos binarios de los adjuntos no se incluyen en JSON.

curl -sS \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example"

Campos importantes del correo

Descargar un adjunto

Descarga un adjunto como archivo binario. Usa el id del correo y attachments[].id devueltos por GET /api/email/{id}. Cada descarga consume 1 solicitud API.

curl -fL -OJ \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example/attachment/attachment-id"

El cuerpo de la respuesta es el archivo. El servidor establece Content-Type, Content-Length y Content-Disposition. curl -OJ guarda el archivo con el nombre seguro proporcionado por el servidor. Los errores de adjuntos se devuelven como texto sin formato.

Eliminar un mensaje

Elimina permanentemente el mensaje identificado por id. Obtén antes el ID mediante /api/emails. Esta acción no se puede deshacer.

curl -sS -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example"

{"success":true,"data":{"message":"Email deleted"},"usage":{"daily_limit":100,"used_today":4,"remaining_today":96,"total_limit":1000,"total_used":4,"remaining_total":996}}

Vaciar una bandeja

Elimina permanentemente todos los mensajes almacenados de la bandeja pública indicada y devuelve el número eliminado. Esta acción no se puede deshacer.

curl -sS -X DELETE -G \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://cleantempmail.com/api/emails/clear"

{"success":true,"data":{"message":"Deleted 3 emails","count":3},"usage":{"daily_limit":100,"used_today":5,"remaining_today":95,"total_limit":1000,"total_used":5,"remaining_total":995}}

Endpoints de estadísticas

Devuelve estadísticas públicas almacenadas en caché. Cada ruta es una solicitud protegida independiente y consume 1 solicitud. Los correos de dominios privados se excluyen de las estadísticas públicas.

curl -sS \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/stats"

{
  "success": true,
  "data": {
    "total_emails": 1250000,
    "today_emails": 32000,
    "emails_24h": 41000,
    "unique_subjects": 8600,
    "active_domains": 1832
  },
  "usage": { "daily_limit": 100, "used_today": 6, "remaining_today": 94, "total_limit": 1000, "total_used": 6, "remaining_total": 994 }
}

Consultar la cuota de una clave API

Devuelve el estado y uso de una clave comprada, creada manualmente, agotada o de prueba compartida, sin consumir cuota. Envía la clave en X-API-Key, la opción recomendada, o en el campo JSON api_key.

curl -sS -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/api-key/usage"

curl -sS -X POST \
  -H "Content-Type: application/json" \
  --data '{"api_key":"ct-test"}' \
  "https://cleantempmail.com/api/api-key/usage"

{
  "success": true,
  "data": {
    "masked_key": "••••••••wxyz",
    "status": "active",
    "is_active": true,
    "daily_limit": 100,
    "used_today": 6,
    "remaining_today": 94,
    "total_limit": 1000,
    "total_used": 6,
    "remaining_total": 994
  }
}

status puede ser active, exhausted o inactive. Las claves compradas agotadas siguen siendo consultables. Nunca se devuelve la clave completa ni los metadatos de Stripe o del cliente.