Chaves da API Temp Mail para automatizar testes de e-mail

Listar domínios públicos ativos

Retorna os domínios disponíveis para gerar endereços. Este recurso público não requer chave API nem consome cota. Os domínios privados do GPTMail são excluídos.

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
  }
}

Gerar um endereço de e-mail temporário

GET cria um endereço com prefixo gerado e domínio ativo aleatório. POST permite escolher prefixo, domínio ou ambos. O endereço final sempre é retornado em 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"

Se o domínio solicitado não estiver mais ativo, a API retorna HTTP 409 em vez de trocar de domínio silenciosamente.

Listar mensagens de uma caixa

Retorna até as 500 mensagens mais recentes de um endereço público do CleanTempMail. Uma caixa nova ou vazia retorna emails: [] e 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 }
}

Obter uma mensagem completa

Usa o id retornado por /api/emails para obter texto/HTML, cabeçalhos, datas e metadados dos anexos. Os dados binários dos anexos não são incluídos no JSON.

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

Campos importantes do e-mail

Baixar um anexo

Baixa um anexo como arquivo binário. Use o id do e-mail e attachments[].id retornados por GET /api/email/{id}. Cada download consome 1 solicitação API.

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

O corpo da resposta é o próprio arquivo. O servidor define Content-Type, Content-Length e Content-Disposition. curl -OJ salva o nome de arquivo seguro fornecido pelo servidor. Erros de anexos são retornados como texto simples.

Excluir uma mensagem

Exclui permanentemente a mensagem identificada por id. Obtenha primeiro o ID em /api/emails. Esta ação não pode ser desfeita.

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}}

Limpar uma caixa

Exclui permanentemente todas as mensagens armazenadas da caixa pública indicada e retorna a quantidade excluída. Esta ação não pode ser desfeita.

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 estatísticas

Retorna estatísticas públicas do serviço armazenadas em cache. Cada caminho é uma solicitação protegida independente e consome 1 solicitação. E-mails de domínios privados são excluídos das estatí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 a cota da chave API

Retorna o estado e uso de uma chave comprada, criada manualmente, esgotada ou de teste compartilhada, sem consumir cota. Envie a chave em X-API-Key, opção recomendada, ou no 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 é active, exhausted ou inactive. Chaves compradas esgotadas continuam consultáveis. A chave completa e os metadados do Stripe ou do cliente nunca são retornados.