A API REST do e-mail temporário
Integre e-mail descartável, caixa temporária e detecção de OTP nos seus apps com poucas linhas. REST simples, JSON limpo, CORS aberto, sem autenticação.
Teste diretamente do navegador
Você não precisa do Postman nem de um terminal. Escolha um endpoint, ajuste os parâmetros e execute. A resposta real da API aparece ao vivo.
Clique em “Executar” para enviar a requisição…
Clique em “Executar” para enviar a requisição…
Clique em “Executar” para enviar a requisição…
Sem parâmetros. Retorna a lista de domínios de e-mail ativos.
Clique em “Executar” para enviar a requisição…
Endpoints
Todos os endpoints usam HTTPS, retornam JSON UTF-8 e incluem os cabeçalhos X-RateLimit-* para você acompanhar seu consumo.
Copie e cole na sua stack
Fluxo completo: criar uma caixa → consultar os e-mails → extrair o código OTP. Na linguagem que você preferir.
Limites de taxa
A API pública é gratuita e limitada por IP. As contas Premium multiplicam esses limites (×2–10) e têm uma cota por conta com sua chave de API.
- Criar uma caixa, 5/min · 50/h
- Ler mensagens, 10/min · 50/h
- Domínios, 10/min
- Cota por conta (não compartilhada por IP)
Limites por plano
| Plano | Criar uma caixa | Ler mensagens | Domínios |
|---|---|---|---|
| Grátis (por IP) | 5/min · 50/h | 10/min · 50/h | 10/min |
| Mensal ×2 | 10/min · 100/h | 20/min · 100/h | 20/min |
| Anual ×2 | 10/min · 100/h | 20/min · 100/h | 20/min |
| Mensal API+ ×10 | 50/min · 500/h | 100/min · 500/h | 100/min |
Seja Premium para multiplicar seus limites.
O que os devs constroem com isto
Usos concretos da API do mail123, de testes e2e à automação de marketing. Todos legítimos, todos sem cadastro.
Testes e2e automatizados
Playwright, Cypress, Selenium: gere um endereço na hora, preencha o formulário, leia o e-mail de confirmação e extraia o link ou o código. Ciclo completo em 30 segundos.
Contornar a verificação de e-mail
Cadastre-se em serviços duvidosos, crie contas descartáveis para testar uma demo ou acesse uma vez conteúdos que exigem e-mail, sem poluir sua caixa principal.
Bots e automação
Scrapers que precisam passar por uma confirmação de e-mail, fluxos n8n/Make/Zapier, scripts Selenium que automatizam o onboarding. A API se integra com 3 linhas.
Ambientes de desenvolvimento
Ambientes de staging e preview: troque Mailtrap, MailHog ou SES por uma API pública. O time vê e-mails reais sem configurar SMTP.
Tutoriais e cursos
Demos de webhooks, exercícios de OAuth, treinamento em segurança: um endereço público descartável permite praticar sem arriscar a caixa de e-mail real.
Ferramentas de privacidade
Extensões de navegador, gerenciadores de senhas, ferramentas antispam: integre a geração de aliases em uma única chamada HTTP.
Códigos HTTP e tratamento de erros
Todas as respostas incluem um campo success: bool e um campo opcional error: string. Os códigos HTTP seguem as convenções REST.
| Code | Significado | Ação |
|---|---|---|
| 200 | Success | A resposta inclui success: true |
| 400 | Bad Request | Verifique a sintaxe do endereço ou do parâmetro |
| 403 | Forbidden | Endereço reservado (admin, root, postmaster…) |
| 404 | Not Found | E-mail não encontrado ou expirado |
| 429 | Too Many Requests | Aguarde 1 minuto ou tente de novo após a reposição |
| 500 | Server Error | Erro do servidor: tente de novo e, se persistir, fale com o suporte |
Perguntas frequentes
Respostas às perguntas que os desenvolvedores mais nos fazem.
A API é mesmo gratuita?
Preciso de uma chave de API?
A API aceita CORS?
Por quanto tempo os e-mails são guardados?
A API detecta os códigos OTP automaticamente?
Quais domínios de e-mail estão disponíveis?
mail123.frmail456.frmail789.frmail1mail.commail123.clickmail123.com.brmail123.beermail123box.techmail123.promail123.sitemail123.onlinemail123.techmail123.website. Lista ao vivo com GET /api/v1/domains.A API aceita webhooks?
O que acontece se eu atingir o limite de requisições?
Quais usos são permitidos?
O serviço é confiável? Qual a disponibilidade?
Construa algo legal
Sem cadastro. Sem cartão. Sem configurar webhooks. Faça sua primeira chamada à API em 10 segundos.