DisposableCheck

Disposable Email Verification API Documentation

Integrate disposable email detection into your application with our free API.

GET
Check Email

Check if an email address is from a disposable email provider.

Endpoint

GET https://disposablecheck.irensaltali.com/api/v1/check?email={email}&check_reachable=true

Query Parameters

check_reachable (optional, boolean): Set to true to enable deep verification (MX & SMTP). Defaults to false.

Headers

X-API-Key: your_api_key_here

Response

{
  "email": "user@tempmail.com",
  "domain": "tempmail.com",
  "is_disposable": true,
  "is_valid_format": true,
  "checked_at": "2026-01-15T10:30:00Z",
  "reacher": {
    "is_reachable": "safe",
    "mx": { "accepts_mail": true, "records": [...] },
    "smtp": { "can_connect_smtp": true, "has_full_inbox": false, ... }
  }
}

Code Examples

Quick start examples in popular languages.

const response = await fetch(
  'https://disposablecheck.irensaltali.com/api/v1/check?email=user@example.com&check_reachable=true',
  {
    headers: {
      'X-API-Key': 'your_api_key_here'
    }
  }
);

const data = await response.json();
console.log(data);

MCP Server (Claude / AI Clients)

Use DisposableCheck directly inside Claude Code, Claude Desktop, or any MCP-compatible AI client — no integration code required.

Stateless Streamable HTTP endpoint — connect any MCP client directly:

POST https://disposablecheck.irensaltali.com/mcp
X-API-Key: dk_live_YOUR_KEY

Raw example with curl:

curl -X POST https://disposablecheck.irensaltali.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'X-API-Key: dk_live_YOUR_KEY' \
  -d '{
    "jsonrpc": "2.0", "id": 1,
    "method": "tools/call",
    "params": {
      "name": "check_email",
      "arguments": { "email": "user@mailinator.com" }
    }
  }'

Available Tools

check_email
API key required

Check if an email is disposable. Pass check_reachable: true for live MX + SMTP deep verification.

get_key_info

View daily limit, requests used today, and remaining quota for an API key account.

get_stats

Get aggregate platform stats: total checks, disposable domains tracked, and community reports.

report_domain

Submit a domain for review as a disposable provider. Reports are reviewed before being added to the blocklist.

Rate Limits

API usage limits per tier.

Free Tier

  • • 1,000 requests per day
  • • Single email checks
  • • Email support
  • • Attribution required (backlink)

Pro Tier

  • • 100,000 requests per day
  • • Bulk email checks
  • • Priority support