✉ Email Temporário

API aberta

Crie caixas temporárias e leia emails com uma API HTTP simples, ideal para testes automatizados e verificação de cadastros. Todos os endpoints retornam JSON.

Autenticação

Criar uma caixa retorna um token. Envie-o nas solicitações seguintes:

Authorization: Bearer <token>

Limites de uso

Sem chave de API, cada IP pode criar até 10 caixas por minuto. Para limites maiores, envie uma chave de API ao criar caixas:

X-API-Key: tm_xxxxxxxxxxxxxxxx

Endpoints

MétodoCaminhoDescrição
GET/api/domainsListar domínios disponíveis
POST/api/mailboxCriar uma caixa. Corpo vazio para endereço aleatório, ou {"local":"abc","domain":"…"} para um personalizado
GET/api/mailboxInformações da caixa atual
DELETE/api/mailboxExcluir a caixa e todos os seus emails
GET/api/messagesListar a caixa de entrada (últimos 100)
GET/api/messages/{id}Obter um email (corpo e anexos)
DELETE/api/messages/{id}Excluir um email
GET/api/messages/{id}/rawBaixar o .eml original
GET/api/attachments/{id}Baixar um anexo
GET/api/eventsFluxo de eventos SSE, envia event: mail quando chegam novos emails

Exemplos

# 1. Criar uma caixa. Corpo vazio para endereço aleatório, ou {"local":"abc","domain":"…"} para um personalizado
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 a caixa de entrada (últimos 100)
curl -s https://www.temp-mail.cc/api/messages \
  -H 'Authorization: Bearer <token>'

# 3. Obter um email (corpo e anexos)
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)

Erros

Em caso de erro, é retornado um status diferente de 2xx com corpo JSON:

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

← Voltar ao início