API Reference

POST /v1/email/validate — Single email (no auth, 20/day per IP)

curl -X POST https://nopii.xyz/v1/email/validate \
  -H "Content-Type: application/json" \
  -d '{"email": "user@gmail.com"}'

Response:

{
  "email": "user@gmail.com",
  "valid": true,
  "format_ok": true,
  "mx_ok": true,
  "disposable": false,
  "domain": "gmail.com",
  "suggestion": null
}

Bulk validation (requires API key, max 50 emails)

curl -X POST https://nopii.xyz/v1/email/validate \
  -H "Content-Type: application/json" \
  -H "x-api-key: nopii_YOUR_KEY" \
  -d '{"emails": ["a@gmail.com", "b@tempmail.com"]}'

GET /v1/email/validate?email=user@gmail.com — Quick check via query string

Get a free API key:

curl -X POST https://nopii.xyz/v1/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

How Email Validation Works

Our email validator runs a multi-step verification pipeline to determine if an email address is safe to send to:

RFC 5322 format check — Verifies the local-part and domain conform to email address standards, catching obvious syntax errors like missing @ symbols or invalid characters.
MX record lookup — Queries DNS to confirm the domain has mail exchange records, meaning the domain is actually set up to receive email.
Disposable domain detection — Checks against a continuously updated list of throwaway email providers (Mailinator, Guerrilla Mail, etc.) that are commonly used for spam signups.
Typo suggestion — Detects common domain misspellings like "gmial.com" or "yaho.com" and suggests the correct domain.

Use the free API to integrate email validation into your signup forms, CRM pipelines, or data cleaning workflows. See also our DNS Lookup tool for manual MX record inspection.

API Reference

How Email Validation Works

Related Developer Tools