Email Validator: Disposable
Listar verificações de descartáveis
Todas as verificações de disposable que você fez, da mais nova para a mais antiga, pela API e pelo dashboard. Grátis: não usa créditos.
https://g.sendcorex.com/v1/tool/validatecommand: list_disposable_checksRequer o escopo tools:validate na sua API key.
Argumentos
limitnumberopcionalTamanho da página, de 1 a 100. Padrão: 50.
ex.:
50cursorstringopcionalO
next_cursorda página anterior.
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "list_disposable_checks",
args: {
limit: 50
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Resposta
{
"type": "SUCCESS",
"results": [
{
"command": "list_disposable_checks",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"checks": [
{
"id": "7d1e2f3a-4b5c-4d6e-8f9a-0b1c2d3e4f5a",
"email": "john@mailinator.com",
"domain": "mailinator.com",
"blocked": true,
"is_disposable": true,
"high_risk": true,
"code": "fully_confirmed",
"reason": "Confirmed",
"checks": [
{
"check": "Domain Blocklist Match",
"status": "Failed",
"details": "Domain found in known disposable list"
}
],
"created_at": "2026-10-21T01:00:02.118Z"
}
],
"count": 1,
"total": 128,
"has_more": true,
"next_cursor": "aDowMDAwMDAwMDgzOjgyMzkzMTU5OTg3OTU6NGM1ZDZlN2Y"
}
}
]
}Campos da resposta
checksEsta página, da mais nova para a mais antiga.
checks[].idO id desta verificação.
checks[].email / domainO que foi verificado.
unknown@<domain>quando só um domínio foi enviado.checks[].is_disposable / high_risk / code / reasonO veredito, igual ao Check Disposable.
checks[].blockedtruequando a verificação indicou bloquear (descartável ou alto risco).checks[].checksAs verificações que rodaram.
checks[].created_atQuando foi verificado. ISO 8601, UTC.
count / totalItens nesta página / todas as suas verificações.
has_more / next_cursorEnquanto
has_morefortrue, envienext_cursorcomocursor.
Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
INVALID_API_KEYA API key não existe, foi revogada ou foi desativada no dashboard.
- 429
RATE_LIMITEDMais de 75 requisições/s ou 75 simultâneas para o mesmo IP + API key. Aguarde o número de segundos em Retry-After.
- CMD
MISSING_SCOPEA API key não tem `tools:validate`.
- CMD
INVALID_ARGSUm argumento é inválido: email ausente (ou domínio, em `check_disposable`), mais de 50 emails, um endereço com mais de 254 caracteres, limit fora do intervalo…
- CMD
INVALID_CURSORO cursor está malformado ou veio de outra busca. Comece de novo sem cursor.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.