Real-Time Email Verification API

https://client.myemailverifier.com/verifier/validate_single/[email protected]/API_KEY

curl "https://client.myemailverifier.com/verifier/validate_single/[email protected]/API_KEY"

 {
        "Address":"[email protected]",
        "catch_all": "false",
        "Status":"Valid",
        "Disposable_Domain":"false",
        "Role_Based":"true"
        "Free_Domain":"false",
        "Greylisted":"false",
        "Diagnosis":"Mailbox Exists and Active"
    }

https://client.myemailverifier.com/verifier/getcredits/API_KEY

curl "https://client.myemailverifier.com/verifier/getcredits/API_KEY"

{
	Credits: "7800"
}

https://client.myemailverifier.com/verifier/upload_file

if (function_exists('curl_file_create'))
    {
        $file = curl_file_create('c:\temp\emails.txt');
    }
    else
    {
        $file = '@c:\tempemails.txt';
    }
    $data['filename'] = $file;
    $data['api_key'] = 'API_KEY';
    $url = 'https://client.myemailverifier.com/verifier/upload_file/';
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $file_id = curl_exec($ch); //return FILE ID to get file status and download url
    curl_close($ch); 

{
	"status": true,
	"file_name": "emails.txt",
	"file_id": 1670,
	"msg": "File uploaded successfully."
}

https://client.myemailverifier.com/verifier/file_info/API_KEY/FILE_ID

curl "https://client.myemailverifier.com/verifier/file_info/YOUR_API_KEY/1669"

{
  "status": true,
  "file": {
    "upload_id": 1669,
    "user_id": 54838,
    "filename": "my-list.csv",
    "created_at": "2026-06-19T10:22:00.000000Z",

    "ready_for_download": 1,
    "status": "finished",
    "status_label": "completed",
    "downloadable": true,

    "progress_percent": 100,
    "total_emails": 5000,
    "processed_res": 5000,

    "phase": "Validating emails",
    "percent_phase1": 100,
    "percent_phase2": 100,
    "unique_domains": 412,
    "domains_checked_p1": 412,
    "domains_checked_p2": 412,

    "total": 5000,
    "valid": 3800,
    "invalid": 750,
    "catchall": 320,
    "unknown": 80,
    "duplicates": 50,
    "spam_trap": 12,
    "toxic_domains": 38,
    "credit_used": 4950,

    "result_counts": {
      "Valid": 3800,
      "Invalid": 750,
      "CatchAll": 320,
      "Unknown": 80,
      "Spamtrap": 12,
      "Disposable": 38,
      "Duplicate": 50
    },

    "download_all_csv":      "https://client.myemailverifier.com/downloadreport/csv/...",
    "download_valid_csv":    "https://client.myemailverifier.com/downloadreport/validcsv/...",
    "download_invalid_csv":  "https://client.myemailverifier.com/downloadreport/invalidcsv/...",
    "download_catchall_csv": "https://client.myemailverifier.com/downloadreport/catchallcsv/...",
    "download_unknown_csv":  "https://client.myemailverifier.com/downloadreport/unknowncsv/...",
    "download_xls":          "https://client.myemailverifier.com/downloadreport/xls/...",

    "file_path":             "https://client.myemailverifier.com/downloadreport/csv/...",
    "xls_file_path":         "https://client.myemailverifier.com/downloadreport/xls/..."
  }
}

upload response received
        ↓
  status_label = "queued"        (ready_for_download = 0)
        ↓ processing begins
  status_label = "processing"    (ready_for_download = 3)
        ↓ all emails done
  status_label = "completed"     (ready_for_download = 1)
                                  → downloadable = true
                                  → progress_percent = 100

Phase 1 - Domain Blacklist & MX Check
  ↓  (percent_phase1: 0->100)
Phase 2 - Catch-All Domain Detection
  ↓  (percent_phase2: 0->100)
Phase 3 - Individual SMTP Email Validation
       (progress_percent: 0->100, phase = "Validating emails")

async function trackBulkVerification(apiKey, fileId) {
  const url = `https://client.myemailverifier.com/verifier/file_info/${apiKey}/${fileId}`;

  while (true) {
    const res = await fetch(url);
    const data = await res.json();

    if (!data.status) { console.error('API error:', data.message); break; }

    const f = data.file;

    // Main progress bar (0-100)
    document.getElementById('progress-bar').style.width = f.progress_percent + '%';
    document.getElementById('progress-label').textContent = f.progress_percent + '%';

    // Phase sub-progress
    if (f.phase) document.getElementById('phase-label').textContent = f.phase;
    if (f.percent_phase1 < 100) showPhaseBar('phase1-bar', f.percent_phase1);
    else if (f.percent_phase2 < 100) showPhaseBar('phase2-bar', f.percent_phase2);

    // Live counts
    document.getElementById('count-valid').textContent    = f.valid;
    document.getElementById('count-invalid').textContent  = f.invalid;
    document.getElementById('count-catchall').textContent = f.catchall;
    document.getElementById('count-unknown').textContent  = f.unknown;

    if (f.status_label === 'completed') {
      renderResultChart(f.result_counts);
      if (f.download_valid_csv)    showDownloadBtn('valid',    f.download_valid_csv);
      if (f.download_invalid_csv)  showDownloadBtn('invalid',  f.download_invalid_csv);
      if (f.download_catchall_csv) showDownloadBtn('catchall', f.download_catchall_csv);
      if (f.download_unknown_csv)  showDownloadBtn('unknown',  f.download_unknown_csv);
      if (f.download_xls)          showDownloadBtn('xls',      f.download_xls);
      showDownloadBtn('all', f.download_all_csv);
      break;
    }

    // Wait 30 seconds before next poll (server updates every 30s-1min)
    await new Promise(resolve => setTimeout(resolve, 30000));
  }
}

// Chart.js - pie chart
new Chart(document.getElementById('resultsChart'), {
  type: 'pie',
  data: {
    labels: Object.keys(f.result_counts),   // ['Valid','Invalid','CatchAll',...]
    datasets: [{
      data: Object.values(f.result_counts),
      backgroundColor: [
        '#22c55e', // Valid      - green
        '#ef4444', // Invalid    - red
        '#f59e0b', // CatchAll   - amber
        '#6b7280', // Unknown    - gray
        '#8b5cf6', // Spamtrap   - purple
        '#f97316', // Disposable - orange
        '#64748b'  // Duplicate  - slate
      ]
    }]
  }
});

// ApexCharts - donut chart
new ApexCharts(document.getElementById('resultsChart'), {
  series: Object.values(f.result_counts),
  labels: Object.keys(f.result_counts),
  chart: { type: 'donut' },
  colors: ['#22c55e','#ef4444','#f59e0b','#6b7280','#8b5cf6','#f97316','#64748b']
}).render();

{ "status": false, "message": "Invalid API Key" }        // 401
{ "status": false, "message": "Unauthorized Request" }   // 403
{ "status": false, "message": "File not found" }         // 404

 {
    "status": false,
    "message": "Too many requests. Please try again later.",
    "retryAfter": 60
}