La API REST del email temporal

Integra el email desechable, la bandeja temporal y la detección de OTP en tus apps con unas pocas líneas. REST sencillo, JSON limpio, CORS abierto, sin autenticación.

4 endpoints
13 dominios
7j retención
0€ coste

Límites más altos con Premium

La API es gratuita para todos. Las cuentas Premium obtienen límites de tasa multiplicados y se autentican con su clave API personal.

Límites de tasa
Mensual ×2 10/min · 20/min
Anual ×2 10/min · 20/min
Mensual API+ ×10 50/min · 100/min
Autenticación

Obtén tu clave API personal desde tu cuenta y pásala como encabezado:

X-API-Key: m123_ak_… Hazte Premium

Pruébalo directamente desde tu navegador

No necesitas Postman ni un terminal. Elige un endpoint, ajusta los parámetros y ejecuta. La respuesta real de la API aparece en directo.

Petición
GET https://mail123.fr/api/v1/mailbox/new
Respuesta
Pulsa «Ejecutar» para lanzar la petición…
Petición
GET https://mail123.fr/api/v1/mailbox/{address}/messages
Respuesta
Pulsa «Ejecutar» para lanzar la petición…
Petición
GET https://mail123.fr/api/v1/mailbox/{address}/messages/{id}
Respuesta
Pulsa «Ejecutar» para lanzar la petición…
Petición
GET https://mail123.fr/api/v1/domains

Sin parámetros. Devuelve la lista de dominios de email activos.

Respuesta
Pulsa «Ejecutar» para lanzar la petición…

Endpoints

Todos los endpoints usan HTTPS, devuelven JSON UTF-8 e incluyen las cabeceras X-RateLimit-* para que sigas tu consumo.

Copia y pega en tu stack

Flujo completo: crear una bandeja → consultar los emails → extraer el código OTP. En el lenguaje que prefieras.

# 1. Crear una bandeja ADDR=$(curl -s https://mail123.fr/api/v1/mailbox/new | jq -r '.address') echo "Mailbox: $ADDR" # 2. Consultar cada 5 s hasta recibir un código OTP while true; do RESP=$(curl -s "https://mail123.fr/api/v1/mailbox/$ADDR/messages") OTP=$(echo $RESP | jq -r '.messages[0].otp_code // empty') [ -n "$OTP" ] && echo "OTP: $OTP" && break sleep 5 done
// 1. Crear una bandeja const { address } = await fetch('https://mail123.fr/api/v1/mailbox/new').then(r => r.json()) console.log('Mailbox:', address) // 2. Consultar cada 5 s hasta recibir un código OTP async function waitForOTP() { while (true) { const { messages } = await fetch(`https://mail123.fr/api/v1/mailbox/${address}/messages`).then(r => r.json()) const otp = messages.find(m => m.otp_code)?.otp_code if (otp) return otp await new Promise(r => setTimeout(r, 5000)) } } console.log('OTP:', await waitForOTP())
import requests, time # 1. Crear una bandeja addr = requests.get('https://mail123.fr/api/v1/mailbox/new').json()['address'] print(f'Mailbox: {addr}') # 2. Consultar cada 5 s hasta recibir un código OTP while True: msgs = requests.get(f'https://mail123.fr/api/v1/mailbox/{addr}/messages').json()['messages'] otp = next((m['otp_code'] for m in msgs if m.get('otp_code')), None) if otp: print(f'OTP: {otp}'); break time.sleep(5)
<?php // 1. Crear una bandeja $res = json_decode(file_get_contents('https://mail123.fr/api/v1/mailbox/new'), true); $addr = $res['address']; echo "Mailbox: $addr\n"; // 2. Consultar cada 5 s hasta recibir un código OTP while (true) { $msgs = json_decode(file_get_contents("https://mail123.fr/api/v1/mailbox/$addr/messages"), true)['messages']; foreach ($msgs as $m) { if (!empty($m['otp_code'])) { echo "OTP: {$m['otp_code']}\n"; exit; } } sleep(5); }
package main import ("encoding/json"; "fmt"; "net/http"; "time") func main() { // 1. Crear una bandeja r, _ := http.Get("https://mail123.fr/api/v1/mailbox/new") var box struct{ Address string } json.NewDecoder(r.Body).Decode(&box) // 2. Consultar cada 5 s hasta recibir un código OTP for { r, _ := http.Get("https://mail123.fr/api/v1/mailbox/" + box.Address + "/messages") var res struct{ Messages []struct{ OtpCode string `json:"otp_code"` } } json.NewDecoder(r.Body).Decode(&res) for _, m := range res.Messages { if m.OtpCode != "" { fmt.Println("OTP:", m.OtpCode); return } } time.Sleep(5 * time.Second) } }
require 'net/http'; require 'json' # 1. Crear una bandeja addr = JSON.parse(Net::HTTP.get(URI('https://mail123.fr/api/v1/mailbox/new')))['address'] puts "Mailbox: #{addr}" # 2. Consultar cada 5 s hasta recibir un código OTP loop do msgs = JSON.parse(Net::HTTP.get(URI("https://mail123.fr/api/v1/mailbox/#{addr}/messages")))['messages'] otp = msgs.find { |m| m['otp_code'] }&.dig('otp_code') if otp then puts "OTP: #{otp}"; break end sleep 5 end

Límites de tasa

La API pública es gratuita y limitada por IP. Las cuentas Premium multiplican estos límites (×2–10) y tienen una cuota por cuenta con su clave API.

Gratis · por IP
50/h
sin clave, sin registro
  • Crear una bandeja, 5/min · 50/h
  • Leer mensajes, 10/min · 50/h
  • Dominios, 10/min
Premium · por cuenta
Cada plan Premium multiplica los límites gratuitos. Los límites de pago se aplican por cuenta, con la cabecera X-API-Key.
  • Cuota por cuenta (no compartida por IP)

Límites por plan

Oferta Crear una bandeja Leer mensajes Dominios
Gratis (por IP) 5/min · 50/h 10/min · 50/h 10/min
Mensual ×2 10/min · 100/h 20/min · 100/h 20/min
Anual ×2 10/min · 100/h 20/min · 100/h 20/min
Mensual API+ ×10 50/min · 500/h 100/min · 500/h 100/min

Hazte Premium para multiplicar tus límites.

Lo que los devs construyen con esto

Usos concretos de la API de mail123, de los tests e2e a la automatización de marketing. Todos legítimos, todos sin registro.

Tests e2e automatizados

Playwright, Cypress, Selenium: genera una dirección al vuelo, rellena el formulario, lee el email de confirmación y extrae el enlace o el código. Ciclo completo en 30 segundos.

Saltarse la verificación de email

Regístrate en servicios dudosos, crea cuentas desechables para probar una demo o accede una sola vez a contenido que pide email, sin ensuciar tu bandeja principal.

Bots y automatización

Scrapers que deben superar una confirmación por email, flujos de n8n/Make/Zapier, scripts de Selenium que automatizan el onboarding. La API se integra con 3 líneas.

Entornos de desarrollo

Entornos de staging y preview: sustituye Mailtrap, MailHog o SES por una API pública. El equipo ve emails reales sin configurar SMTP.

Tutoriales y formación

Demos de webhooks, ejercicios de OAuth, formación en seguridad: una dirección pública desechable permite practicar sin arriesgar la bandeja real.

Herramientas de privacidad

Extensiones de navegador, gestores de contraseñas, herramientas antispam: integra la generación de alias en una sola llamada HTTP.

Códigos HTTP y gestión de errores

Todas las respuestas incluyen un campo success: bool y un campo opcional error: string. Los códigos HTTP siguen las convenciones REST.

CodeSignificadoAcción
200SuccessLa respuesta incluye success: true
400Bad RequestRevisa la sintaxis de la dirección o del parámetro
403ForbiddenDirección reservada (admin, root, postmaster…)
404Not FoundEmail no encontrado o caducado
429Too Many RequestsEspera 1 minuto o reintenta tras el restablecimiento
500Server ErrorError del servidor: reintenta y, si persiste, contacta con soporte

Preguntas frecuentes

Respuestas a las preguntas que más nos hacen los desarrolladores.

¿La API es realmente gratuita?
Sí, completamente gratuita. Sin tarjeta, sin registro y sin límites ocultos. 30 peticiones por hora y por IP cubren la mayoría de usos personales y de prueba. Para más, pronto llegará el plan Pro.
¿Necesito una clave API?
No. La API pública funciona sin autenticación. Con Pro (próximamente), una cabecera X-API-Key desbloqueará límites más altos.
¿La API admite CORS?
Sí, CORS está totalmente abierto (Access-Control-Allow-Origin: *). Puedes llamar a la API directamente desde el navegador en JavaScript, sin proxy.
¿Cuánto tiempo se conservan los emails?
Los emails se eliminan automáticamente 7 días después de recibirlos. La dirección, en cambio, sigue disponible sin límite. Sin almacenamiento persistente de los correos, sin archivo, sin perfil de usuario.
¿La API detecta los códigos OTP automáticamente?
Sí. Cada mensaje devuelto incluye un campo otp_code. Nuestro extractor reconoce códigos numéricos (4-8 dígitos), alfanuméricos y formatos con separador (XX-XX, XX XX). Tiene en cuenta el contexto: la puntuación sube cuando hay palabras como «verificación», «código» u «OTP» cerca.
¿Qué dominios de email hay disponibles?
Dominios activos actualmente: mail123.frmail456.frmail789.frmail1mail.commail123.clickmail123.com.brmail123.beermail123box.techmail123.promail123.sitemail123.onlinemail123.techmail123.website. Lista en vivo con GET /api/v1/domains.
¿La API admite webhooks?
Todavía no. La versión actual exige polling (GET /messages cada 5-10 segundos). Los webhooks están previstos en Pro: notificaciones push HTTPS cuando llegan emails a las bandejas que sigues.
¿Qué pasa si alcanzo el límite de peticiones?
La API devuelve HTTP 429 con una cabecera Retry-After que indica en segundos cuándo reintentar. Las cabeceras X-RateLimit-Remaining y X-RateLimit-Reset permiten vigilar el consumo.
¿Qué usos están permitidos?
Cualquier uso legítimo: tests automatizados, verificación de cuentas de sandbox, automatización del flujo de desarrollo, herramientas de privacidad. Los abusos (spam, scraping masivo, fraude) provocan un bloqueo permanente de la IP sin previo aviso.
¿El servicio es fiable? ¿Qué disponibilidad tiene?
El servicio funciona en servidores OVH en Roubaix, Francia, con un 99,95 % de disponibilidad media en los últimos 12 meses. Estado en tiempo real en status.mail123.fr.

Construye algo genial

Sin registro. Sin tarjeta. Sin configurar webhooks. Haz tu primera llamada a la API en 10 segundos.