Integrate email verification
in under 10 minutes

Authorization: Bearer mc_live_xxxxxxxxxxxxxxxxxxxx

{
  "email": "[email protected]",
  "options": {
    "catch_all": true
  }
}

{
  "email":      "[email protected]",
  "status":     "valid",
  "score":      97,
  "checks": {
    "syntax":     true,
    "dns":        true,
    "mx":         true,
    "smtp":       true,
    "disposable": false,
    "catch_all":  false
  },
  "confidence": "high"
}

# Verify an email address
curl -X POST https://api.mailcheck.fr/v1/verify \
  -H "Authorization: Bearer mc_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","options":{"catch_all":true}}'

import os
import requests

API_KEY = os.environ["MAILCHECK_API_KEY"]

def verify_email(email: str) -> dict:
    response = requests.post(
        "https://api.mailcheck.fr/v1/verify",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "email": email,
            "options": {"catch_all": True}
        },
        timeout=5
    )
    response.raise_for_status()
    return response.json()

# Usage example
result = verify_email("[email protected]")
if result["status"] == "valid":
    print(f"✓ Valid email · Score: {result['score']}")
else:
    print(f"✗ Status: {result['status']}")

const API_KEY = process.env.MAILCHECK_API_KEY;

async function verifyEmail(email) {
  const res = await fetch("https://api.mailcheck.fr/v1/verify", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      email,
      options: { catch_all: true }
    })
  });

  if (!res.ok) {
    throw new Error(`API error: ${res.status}`);
  }

  return res.json();
}

// Usage example
verifyEmail("[email protected]")
  .then(data => {
    console.log(`Status: ${data.status} · Score: ${data.score}`);
  })
  .catch(console.error);

{
  "error": "insufficient_credits",
  "message": "Your monthly quota is exhausted. Upgrade your plan.",
  "credits_remaining": 0
}