Email Validator: Disposable
List Disposable Checks
Every disposable check you made, newest first, from the API and the dashboard. Free: it does not use credits.
https://g.sendcorex.com/v1/tool/validatecommand: list_disposable_checksNeeds the tools:validate scope on your API key.
Arguments
limitnumberoptionalPage size, from 1 to 100. Defaults to 50.
e.g.
50cursorstringoptionalThe
next_cursorof the previous page.
Quick start
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);Response
{
"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"
}
}
]
}Response fields
checksThis page, newest first.
checks[].idThe id of this check.
checks[].email / domainWhat was checked.
unknown@<domain>when only a domain was sent.checks[].is_disposable / high_risk / code / reasonThe verdict, same as Check Disposable.
checks[].blockedtruewhen the check said to block (disposable or high risk).checks[].checksThe checks that ran.
checks[].created_atWhen it was checked. ISO 8601, UTC.
count / totalItems on this page / all your checks.
has_more / next_cursorWhile
has_moreistrue, sendnext_cursorascursor.
Errors
HTTP-level errors return type, code and message. Errors marked CMD come back inside the command result, with HTTP 200.
- 401
INVALID_API_KEYThe API key does not exist, was revoked or was disabled in the dashboard.
- 429
RATE_LIMITEDMore than 75 requests/s or 75 in flight for the same IP + API key. Wait the number of seconds in Retry-After.
- CMD
MISSING_SCOPEThe API key does not have `tools:validate`.
- CMD
INVALID_ARGSAn argument is invalid: missing email (or domain, for `check_disposable`), more than 50 emails, an address longer than 254 characters, limit out of range…
- CMD
INVALID_CURSORThe cursor is malformed or came from a different search. Start again without one.
- CMD
INTERNALServer error. The detail is only written to the server log.