Email Validator: Disposable
Listar verificaciones de desechables
Todas las comprobaciones de disposable que hiciste, de la más reciente a la más antigua, desde la API y el dashboard. Gratis: no usa créditos.
https://g.sendcorex.com/v1/tool/validatecommand: list_disposable_checksRequiere el scope tools:validate en tu API key.
Argumentos
limitnumberopcionalTamaño de página, de 1 a 100. Por defecto, 50.
p. ej.
50cursorstringopcionalEl
next_cursorde la página anterior.
Inicio 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);Respuesta
{
"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 de la respuesta
checksEsta página, de la más reciente a la más antigua.
checks[].idEl id de esta comprobación.
checks[].email / domainLo que se comprobó.
unknown@<domain>cuando solo se envió un dominio.checks[].is_disposable / high_risk / code / reasonEl veredicto, igual que en Check Disposable.
checks[].blockedtruecuando la comprobación indicó bloquear (desechable o de alto riesgo).checks[].checksLas comprobaciones que se ejecutaron.
checks[].created_atCuándo se comprobó. ISO 8601, UTC.
count / totalElementos en esta página / todas tus comprobaciones.
has_more / next_cursorMientras
has_moreseatrue, envíanext_cursorcomocursor.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
INVALID_API_KEYLa API key no existe, fue revocada o se desactivó en el dashboard.
- 429
RATE_LIMITEDMás de 75 solicitudes/s o 75 simultáneas para la misma IP + API key. Espera el número de segundos indicado en Retry-After.
- CMD
MISSING_SCOPELa API key no tiene `tools:validate`.
- CMD
INVALID_ARGSUn argumento no es válido: falta el email (o el dominio, en `check_disposable`), más de 50 emails, una dirección de más de 254 caracteres, limit fuera de rango…
- CMD
INVALID_CURSOREl cursor está mal formado o viene de otra búsqueda. Empieza de nuevo sin cursor.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.